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Diving In 

Android has been taking the world by storm. 

Everybody wants a smart phone or tablet, and Android devices are hugely popular. In 
this book we’ll teach you how to develop your own apps, and we’ll start by getting 


you to build a basic app and run it on an Android Virtual Device. Along the way you’ll 
meet some of the basic components of all Android apps such as activities and layouts. 
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Apps That Do Something 


Most apps need to respond to the user in some way. 

In this chapter you’ll see how you can make your apps a bit more interactive. You’ll see 
how you can get your app to do something in response to the user, and how to get 
your activity and layout talking to each other like best buddies. Along the way we’ll 
take you a bit deeper into how Android actually works by introducing you to R, the 
hidden gem that glues everything together. 
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To ： AnotherActivity 



multiple acdVxties and Intents 

State Your Intent 

Most apps need more than one activity. 

So far we’ve just looked at single-activity apps, which is fine for simple apps. But when 
things get more complicated, just having the one activity won’t cut it. We’re going to 
show you how to build apps with multiple activities, and how you can get your apps 
talking to each other using intents. Well also look at how you can use intents to go 

beyond the boundaries of your app and make activities in other apps on your 


device perform actions. Things just got a whole lot more powerful... 
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o one thing and do it well 

ctivities form the foundation of every Android app. 

So far you’ve seen how to create activities, and made one activity start another 
ing an intent. But what’s really going on beneath the hood? In this chapter 


we’re going to dig a little deeper into the activity lifecycle. What happens when 
an activity is created and destroyed? Which methods get called when an activity 
is made visible and appears in the foreground, and which get called when the 
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activity loses the focus and is hidden? And how do you save and restore your 
activity’s state? 
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Enjoy the View 

Let’s face it, you need to know how to create great layouts. 

If you’re building apps you want people to use, you need to make sure they look just 
the way you want. So far we’ve only scratched the surface when it comes to creating 
layouts, so it's time to look a little deeper. We’ll introduce you to more types of layout 


you can use, and we’ll also take you on a tour of the main GUI components and how 
you use them. By the end of the chapter you’ll see that even though they all look a little 


different, all layouts and GUI components have more in common than you might 


think. 
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list Views and adapters 

Getting Organized 

L ^ Want to know how best to structure your Android app? 

I You’ve learned about some of the basic building blocks that are used to build apps, 

and now it’s time to get organized. In this chapter we’ll show you how you can take 
a bunch of ideas and structure them into an awesome app. We’ll show you how 
lists of data can form the core part of your app design, and how linking them 
together can create a powerful and easy-to-use app. Along the way, you’ll get your 
first glimpse of using event listeners and adapters to make your app more dynamic. 
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Navigating through the activities 

Use ListViews to navigate to data 

We’re going to build the Starbuzz app 

The drink detail activity 

The Starbuzz app structure 

The top-level layout contains an image and a list 

The full top-level layout code 

Get ListViews to respond to clicks with a Listener 

The full TopLevelActivity code 

How to create a list activity 

Connect list views to arrays with an array adapter 
Add the array adapter to DrinkCategoryActivity 
What happens when you run the code 
How we handled clicks in TopLevelActivity 
The full DrinkG ategoryActivity code 
A detail activity displays data for a single record 
Update the views with the data 
The DrinkActivity code 


TiVis is ouv lis 七 View. 

V 


Test drive the app 
Your Android Toolbox 


ListView 


l/Ve’ll d\rea 七 e 如 a\rray adapiev- -fco 
bmd ouv* I is 七 view "to ou\r a\rv*ay. 

V 




Array 

Adapter 


This is ouv av*v*ay- 


Drink. 

drinks 


228 

229 

230 

231 

232 

233 

234 
238 

240 

241 
243 
249 

251 

252 

253 
256 

258 

259 
261 
263 
266 
268 























table of contents 


fr^ments 



Make it Modular 

You’ve seen how to create apps that work in the same way 
irrespective of the device they’re running on. 

But what if you want your app to look and behave differently depending on whether it’s 


running on a phone or a tablet? In this chapter we’ll show you how to make your app 
choose the most appropriate layout for the device screen size. We ll also introduce 
you to fragments, a way of creating modular code components that can be reused by 


different activities. 


So the fragment will 
contain just a single list. I wonder... 
When we wanted to use an activity 
that contained a single list, we used 
a ListActivity. Is there something 
similar for fragments? 
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Dealing with Children 

You’ve seen how using fragments in activities allow you 
to reuse code and make your apps more flexible. 

In this chapter we’re going to show you how to nest one fragment inside another. 
You’ll see how to use the child fragment manager to tame unruly fragment 
transactions. Along the way you’ll see why knowing the differences between 
activities and fragments is so important. 
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Taking Shortcuts 

Everybody likes a shortcut. 

And in this chapter you’ll see how to add shortcuts to your apps using action bars. 
We’ll show you how to start other activities by adding action items to your action bar, 
how to share content with other apps using the share action provider, and how to 


navigate up your app’s hierarchy by implementing the action bar’s Up button. Along 


the way you’ll see how to give your app a consistant look and feel using themes, and 


introduce you to the Android support library package. 
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Going Places 

Apps are so much better when they’re easy to navigate. 

In this chapter we’re going to introduce you to the navigation drawer, a slide-out 
panel that appears when you swipe the screen with your finger or click an icon on 
the action bar. We’ll show you how to use it to display a list of links that take you to 
all the major hubs of your app. You’ll also see how switching fragments makes 
those hubs easy to get to and fast to display. 
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SQLite database 


SQLite dcttabcises 

Fire up the Database 

■f you’re recording high scores or saving tweets, your app 

will need to store data. And on Android you usually keep your data safe inside 
a SQLite database. In this chapter, well show you how to create a database, add 
tables to it, and prepopulate it with data, all with the help of the friendly SQLite helper. 
You’ll then see how you can cleanly roll out upgrades to your database structure, and 
how to downgrade it if you need to pull any changes. 

Back to Starbuzz 438 
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cursors and asynctasks 

Connecting to Databases 


So how do you connect your app to a SQLite database? 

So far you’ve seen how to create a SQLite database using a SQLite helper. The 
next step is to get your activities to access it. In this chapter you’ll find out how to 
use cursors to get data from the database, how to navigate cursors and how to 
get data from them. You’ll then find out how to use cursor adapters to connect 
them to list views. Finally, you’ll see how writing efficient multi-threaded code with 
AsyncTasks will keep your app speedy. 
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At Your Service 

There are some operations you want to keep on running, 
irrespective of which app has the focus. 

As an example, If you start playing a music file in a music app, you’d probably expect it 
to keep on playing when you switch to another app. In this chapter you’ll see how to use 
services to deal with situations just like this. Along the way you’ll see how use some 
of Android’s built-in services. You’ll see how to to keep your users informed with the 
notification service, and how the location service can tell you where you’re located. 


The started service app 

The IntentService from 50,000 feet 

How to log messages 

The full DelayedMessageService code 

The full DelayedMessageService.java code 

How you use the notification service 

Getting your notification to start an activity 
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material design 

Living in a Material World 

With API level 21, Google introduced Material Design. 

In this chapter well look at what Material Design is, and how to make your apps fit in 
with it. We’ll start by introducing you to card views you can reuse across your app for a 
consistent look and feel. Then we’ll introduce you to the recycler view, the list view’s 
flexible friend. Along the way you’ll see how to create your own adapters, and how to 
completely change the look of a recycler view with just two lines of code. 



Welcome to Material Design 

The Pizza app structure 

Create the Card View 

The full card 一 captioned 一 image.xml code 

Create the basic adapter 

Define the adapter’s ViewHolder 

Create the ViewHolders 

Each card view displays an image and a caption 

Add the data to the card views 

The full code for GaptionedlmagesAdapter.java 

Create the recycler view 

Add the Re cycler View to the layout 

The PizzaMaterialFragment.java code 

A RecyclerView uses a layout manager to arrange its views 

Specifying the layout manager 

The full PizzaMaterialFragment.java code 

Get Main Activity to use the new Pizz aMaterialFragment 

What happens when the code runs 

Create PizzaDetailActivity 

What PizzaDetailActivity.java needs to do 

The code for PizzaDetailActivity.j ava 

Getting a RecyclerView to respond to clicks 

Add the interface to the adapter 

Implement the listener in PizzaMaterialFragment.java 

Bring the content forward 

The full code for fragment 一 top.xml 

The full code for TopFragment.j ava 
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The Android Runtime 



ndroid apps need to run on devices with low powered 
rocessors and very little memory, 

ava apps can take up a lot of memory and because they run inside their own Java 
Virtual Machine (JVM), Java apps can take a long time to start when they’re running 
on low-powered machines. Android deals with this by not using the JVM for its apps. 
Instead it uses a very different virtual machine called the Android Runtime (ART). In 
this appendix well look at how ART gets your Java apps to run well on a small, low- 


powered device. 



.java .class classes.dex .apk 



adt 

The Android Debug Bridge 

In this book we’ve focused on using an IDE for all your 

Android needs. But there are times when using a command line tool can be plain 
useful, like those times when Android Studio can’t see your Android device but you just 
know it’s there. In this chapter we’ll introduce you to the Android Debug Bridge (or adb), 
a command line tool you can use to communicate with the emulator or Android devices. 


adb 

- > 

adbd 

^ — 一 

l 

1 


adb command adb daemon 


process 



Device 
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the emulqtPr 

The Android Emulator 



Ever felt like you were spending all your time waiting for the 
emulator? 

There’s no doubt that using the Android emulator is useful. It allows you to see how 


your app will run on devices other than the physical ones you have access to. But 
at times it can feel a little... sluggish. In this appendix we’re going to explain why 
the emulator can seem slow, Even better, we’ll give you a few tips we’ve learned for 


speeding it up. 


AVD 

AVD 

AVD 

AVD 

AVD 


/\|| ^[Y\dro\d \/*iv-*tual Pcvidcs - ^ 

or\ crwula*tov dalled 6^£A1U. 


QEMU Emulator 
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The Top Ten Things (we didn’t cover) 

Even after all that, there’s still a little more. 

There are just a few more things we think you need to know. We wouldn’t feel right 
about ignoring them, and we really wanted to give you a book you’d be able to lift 


without extensive training at the local gym. Before you put down the book, read 


through these tidbits. 



Android 


1. Distributing your app 

2. Content providers 

3. The Web View class 

4. Animation 

5. Maps 

6. Cursor loaders 

7. Broadcast receivers 

8. App widgets 

9. NinePatch graphics 

10. Testing 
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is this book for you? 

withthl 0kiSf0ranyone 
with the mon ey topa 

for it. And it makes 

a great gift for that 

special someone. 






/••• 


I can’t believe 
they put that \r\ an 
Android book. 
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how to use this book 


Who is this book for? 

If you can answer “yes” to all of these: 


o 

O 

o 


Do you already know how to program in Java? 


Do you want to master Android app development, create 
the next big thing in software, make a small fortune, and 
retire to your own private island? 

Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 


伙 , maykc -bV^a-b s a 
•fadcUW. But Y ou 
S*t3V"*t V ■吵七？ 


for hours on end? 


this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: 


o 

❺ 


Are you looking for a quick introduction or reference book 
to developing Android apps? 


Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do 
you believe an Android book should cover everything, 
especially all the obscure stuff you’ll never use, and if it 
bores the reader to tears in the process, then so much 
the better? 


this book is not for you. 


^ Mav-kctmg ： -this book 
,S ^ 扣 yw with a tYtd\i wd … 

wcl1 PayPal, iooJ 
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Wc know what yo uVg thmkmg 


cc 


u 


How can this be a serious book on developing Android apps?” 
What’s with all the graphics?” 

Gan I actually learn it this way?” 


Wc know what your brain is thmkmg 

Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real]oh — recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important 
filter. 

How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you — what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows"• 

This must be important! Don’t forget it! 

But imagine you’re at home or in a library. It’s a safe, warm, tiger-free zone. \!o^c 
You’re studying. Getting ready for an exam. Or trying to learn some tough 丁 \\\ 幺 ' SV) 

technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to make 
sure that this obviously unimportant content doesn’t clutter up scarce resources. 
Resources that are better spent storing the really big things. Like tigers. 

Like the danger of fire. Like how you should never have posted those 
party photos on your Facebook page. And there’s no simple way 
to tell your brain, “Hey brain, thank you very much, but no matter 
how dull this book is, and how little I’m registering on the emotional 
Richter scale right now, I really do want you to keep this stuff around.’’ 







f Great. Only 600 乂 
f more dull, dry, j 
boring pages. J 

o 
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Metacognition: thinking about thinking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 
Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 


I wonder how 
I can trick my brain 
into remembering 
this stuff... 



The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 
Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 


But we assume that if you’re holding this book, you really want to learn how 
to develop Android apps. And you probably don’t want to spend a lot of time. 
If you want to use what you read in this book, you need to remember what you 
read. And for that, you’ve got to understand it. To get the most from this book, or 
any book or learning experience, take responsibility for your brain. Your brain 
on this content. 


So just how DO you get your brain to treat 
programming like it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning... 
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Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing it refers to, as opposed to in a caption or buried in the body 
text somewhere. 

We used redundancy, saying the same thing in different ways and with different media types, 
and multiple senses, to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise, or interest. 

We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 

We included activities^ because your brain is tuned to learn and remember more when 
you do things than when you read about things. And we made the exercises challenging-yet- 
doable, because that’s what most people prefer. 


We used multiple learning styles, because might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 


We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view ， 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
Thsityou^re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We people. In stories, examples, pictures, etc., because, well, a person. And your 
brain pays more attention to people than it does to things. 
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Here's what YOU caw do to bend 
your bram into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cut -this out 3hd sti 乙 k ii 
° h y ° 你 


o Slow down. The more you understand, the 
less you have to memorize. 

Don’t just read. Stop and think. When the book asks 
you a question, don’t just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And don’t just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

❺ Read “There Are No Dumb Questions.” 

That means all of them. They’re not optional 
sidebars, they ’re part of the core content! 

Don’t skip them. 


o Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

o Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

o Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 


Make this the last thing you read before bed. 
Or at least the last challenging thing. 


Part of the learning (especially the transfer to 
long-term memory) happens afler you put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
processing time, some of what you just learned will 
be lost. 


(D Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
you’re trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better still, try to explain it out loud to someone else. 
You’ll learn more quickly, and you might uncover 
ideas you hadn’t known were there when you were 
reading about it. 


Write a lot of code! 

There’s only one way to learn to develop Android 
apps: write a lot of code. And that’s what you’re 
going to do throughout this book. Coding is a skill, 
and the only way to get good at it is to practice. 
We’re going to give you a lot of practice: every 
chapter has exercises that pose a problem for you 
to solve. Don’t just skip over them — a lot of the 
learning happens when you solve the exercises. We 
included a solution to each exercise — don’t be afraid 
to peek at the solution if you get stuck! (It’s easy 
to get snagged on something small.) But try to solve 
the problem before you look at the solution. And 
definitely get it working before you move on to the 
next part of the book. 
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Read me 


This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 


We assume you’re new to Android, but not to Java. 

We’re going to be building Android apps using a combination of Java and XML. We 
assume that you’re familiar with the Java prorgamming language. If you’ve never done any 
Java programming at all, then you might want to read Head First Java before you start on 
this one. 


We start off by building an app in the very first chapter. 

Believe it or not, even if you’ve never developed for Android before, you can jump right 
in and start building apps. You’ll also learn your way around Android Studio, the official 
IDE for Android development. 


The examples are designed for learning. 

As you work through the book, you’ll build a number of different apps. Some of these are 
very small so you can focus on a specific part of Android. Other apps are larger so you can 
see how different components fit togeher. We won’t complete every part of every app, but 
feel free to experiment finish them off yourself. It’s all part of the learning experience. The 
source code for all the apps here: https://tinyurl.com/HeadFirstAndroid. 


The activities are NOT optional. 

The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. DonH skip the exercises. 


XXX 
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The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learnings so you’ll see some 
of the same concepts come up more than once. 


The Brain Power exercises don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 
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Android has taken the world by storm. 

Everybody wants a smartphone or tablet, and Android devices are hugely popular. In this 
book, we’ll teach you how to develop your own apps, and we’ll start by getting you to 
build a basic app and run it on an Android Virtual Device. Along the way, you’ll meet some 
of the basic components of all Android apps, such as activities and layouts. All you 
need is a little Java know-how... 


this is a new chapter 





android overview 


Welcome to Awdroidville 

Android is the world’s most popular mobile platform. At the 
last count, there were over one billion active Android devices 
worldwide, and that number is growing rapidly. 


Android is a comprehensive open source platform based 
on Linux and championed by Google. It’s a powerful 
development framework that includes everything you need 
to build great apps using a mix of Java and XML. What’s 
more, it enables you to deploy those apps to a wide variety of 
devices — phones, tablets and more. 

So what makes up a typical Android app? 


We’re going to Luilct our 
Android apps using a mixture 

ol Java and XML Well 

explain tilings along tke way ， 
tut you’ll need to kave a fair 
understanctingf oi Java to get 
tke most out oi tkis Look. 


Layouts define what each screen 
looks like 

A typical Android app is comprised of one 
or more screens. You define what each 
screen looks like using a layout to define its 
appearance. Layouts are usually defined using 
XML, and can include GUI components such 
as buttons, text fields, and labels. 

Java code defines what the app 
should do 

Layouts only define the appearance of the app. 
You define what the app does by writing Java 
code. A special Java class called an activity 
decides which layout to use and tells the app 
how to respond to the user. As an example, if 
a layout includes a button, you need to write 
Java code in the activity to define what the 
button should do when you press it. 


Layouts 
七 el I A^dv-oid 
wha-t 七 he 

\f\ 

youv app 
look like- 




(/- y 



Activities dc-f'mc 
v/ha*t ihc aff 
should do. 



Sometimes extra resources are needed too 

In addition to Java code and layouts, Android apps often need 
extra resources such as image files and application data. You 
can add any extra files you need to the app. 

Android apps are really just a bunch of files in particular 
directories. When you build your app, all of these files get 
bundled together, giving you an app you can run on your device. 




Rcsou\rdcs 
乙 dh ii^dlucic ~^ 
SOUK>d dhd 
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getting started 


The Android platform dissected 

The Android platform is made up of a number of 
different components. It includes core applications such 
as Contacts, a set of APIs to help you control what 
your app looks and how it behaves, and a whole load of 
supporting files and libraries. Here’s a quick look at how 
they all fit together: 


Don’t worry if this seems 
like a lot to take in. 



At this stage, we’re just giving 
you an overview of what’s 
included in the Android platform. We’ll explain 
the different components in more detail as and 
when we need to. 


Android comes with a set 
of core applications such 
as Contacts, Calendar, 
Maps, and a browser. 

When you build your apps y 
you have access to the 
same APIs used by the 
core applications. You use 
these APIs to control 
what your app looks like 
and how it behaves. 

Underneath the 
application framework 
lies a set of C and C++ 
libraries. These libraries 
get exposed to you 
through the framework 
APIs. 


Underneath everything 
else lies the Linux kernel. 
Android relies on the 
kernel for drivers, and 
also core services such 
as security and memory 
management. 


Applications 

Home 

Contacts 

Phone 

Browser 

■ ■ ■ 


Application Framework 



Activity 

Manager 

Window 

Manager 

Content 

Providers 

View 

System 


Package 

Manager 

Telephony 

Manager 

Resource 

Manager 

Location 

Manager 

Notification 

Manager 



V 


Surface 

Manager 


OpenGL I 
ES 


SGL 


Libraries 


Media 

Framework 


SQLite 


FreeType 


WebKit 


SSL 


libc 



Linux Kerml 




Display 


Camera 


Flash Memory 


Binder (IPC) 



Driver 


Driver 


Driver 


Driver 








Keypad 


WiFi 


Audiio 


Power 



Driver 


Driver 


Drivers 


Management 


The Android 
runtime 
comes with a 
set of core 
libraries that 
implement 
most of 
the Java 
programming 
language. 
Each Android 
app runs 
in its own 
process. 


The great news is that all of the powerful Android 
libraries are exposed through the APIs in the application 
framework, and it’s these APIs that you use to create 
great Android apps. All you need to begin is some Java 
knowledge and a great idea for an app. 
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steps 


Here's what we’re going to do 

So let’s dive in and create a basic Android app. There are just 
a few things we need to do: 


❸ o 

activity main.xml - [app 】 -My First App - 

[~/And roidStud ioProjects/ MyFirstApp] 


D ^ 0 ： 

^ -rapp ►釔 Cl 

-!： " -i-. 

Q. 

MyFirstApp 

app sre main ^ res layout <> activity_main.xml 



f ； Android 

▼ 0 4= c MainActivity .java x m activity_mainjcml x 


mmmmmmmJrn 


o 


❺ 


o 


o 


Set up a development environment. 

We need to install Android Studio, which 
includes all the tools you need to develop your 
Android apps. 


Build a basic app. 

We’ll build a simple app using Android Studio 
that will display some sample text on the 


screen. 


Run the app in the Android emulator. 

We’ll use the built-in emulator to see the app 
up and running. 


Change the app. 

Finally, we’ll make a few tweaks to the app we 
created in step 2, and run it again. 


there jcH 

)umb 


app 

► Cl manifests 

▼ java 

▼ E] com.hfad.myfirstapp 

c l» MainActivity 

► tL] cuni.hfdd.myrirbiapp ( 

▼ fares 

► Q drawable 

▼ B layout 

& dctivity_rn4in.xml 
. It] mpnu 

► II] values 
® Cradle Scripts 


Palette 睾 • Nexus 4 - ®AppThei 

Cl Layouts 0 ， ’ 皆 21 ， 

I LinearLavout (Vertical) 

PI Table Layout 
固 TableRow 
[— Grid Layout 
53 Relative Layout 
tl Widgets 
@ Plain TextView 
@ Ldrye Text 
@ Medium Text 
@ Small Text 
c Button 
*>*• Small Builun 
'• RadinRurmn 
[✓1 CheckBox 
■o Switch 
一 TugyleBullun 
H ImagpRurton 
Q Image View 
*• ProgressBar (Large) 
mm ProgressBar (Normal) 

Prngrp«Rar (Small) 

■■ ProgressBar (Horizonta 
•o*SeekBar 
•ft ： RaangBar 


Component Tree 
▼ 【 Device Screen 


I # 丨睾一 I 


SI El 0 众 


[AblTcxtVicw @stri ng/ he i i o_ world 






Spinner 

<d WebView 


<3 O □ 

Q Text Fields 

__ »^-i — _____ 

-l_K! 


Q 12:43 

f First App 


• 

• 

• 


Properties 


layoutiheight 
style 

accessibilityLiveRec 

alpha 

background 

backgroundTint 

backgroundTintMo 

clickable 

contentuescripoon 

elevation 

focusable 

focusablelnTouchM 
gravity Q 

id 


? u 


match_parent 


Hello world! 




i6 A Q 4:42 


First App 



Sup doge 


I are no o 

Dumb Questi9ns — 




Are all Android apps developed 
in Java? 

You can develop Android apps in 
other languages too, but the truth is most 
developers use Java. 


How much Java do I need to know 
for Android app development? 

You really need experience of Java 
SE. If you're feeling rusty, we suggest 
getting a copy of Head First Java by Kathy 
Sierra and Bert Bates. 


Do I need to know about Swing 
and AWT? 

Android doesn't use Swing or AWT, 
so don’t worry if you don’t have Java 
desktop GUI experience. 
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You avc hcv-c. 

Your development ewvinwmewf - 

Java is the most popular language used to develop Android applications. _ 

Android devices don’t run .class and .jar files. Instead, to improve speed 
and battery performance, Android devices use their own optimized 
formats for compiled code. That means that you can’t use an ordinary 
Java development environment — you also need special tools to convert 
your compiled code into an Android format, to deploy them to an 
Android device and to let you debug the app once it’s running. 

All of these come as part of the Android SDK. Let’s take a look at 
what’s included. 


getting started 

Set up environment 
Build app 
Run app 
Change app 


The Android SPK 


The Android Software Development Kit contains the libraries and tools 
you need to develop Android apps: 

SDK Platform 

There’s one of these for each 
version of Android. 


SDK Tools 

Tools for debugging and testing, 
plus other useful utilities. It 
also features a set of platform 
dependent tools. 

Sample apps 

If you want practical code 
examples to help you understand ^^ N 
how to use some of the APIs, the 
sample apps might help you. 



Documentation 

So you can get to the latest 
API documentation offline. 


TVse a 代 jus 七 some 
o-f i\\t mam 


Android support 

Extra APIs that aren’t available 
in the standard platform. 


Google Play Billing 

广 Allows you in integrate billing 
services in your app. 


Android Studio is a special version of IntelliJ ll?EA 

IntelliJ IDEA is one of the most popular IDEs for Java development. 
Android Studio is a version of IDEA that includes a version of 
the Android SDK and extra GUI tools to help you with your app 
development. 

In addition to providing you with an editor and access to the tools and 
libraries in the Android SDK, Android Studio gives you templates you 
can use to help you create new apps and classes, and it makes it easy to 
do things such as package your apps and run them. 


you are here ► 
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installation 


Install Java 

Android Studio is a Java development environment, so you need to 
make sure the right version of Java is installed on your machine. 

First, check the Android Studio system requirements to see which 
versions of the Java Development Kit (JDK) and Java Runtime Edition 
JRE) you need. You can see the system requirements here: 

http:/ / developer, android, com/sdk/index. html#Requirements 


When you know which versions of the JDK and JRE you need, you 
can get them from here and install them: 


Set up environment 
Build app 
Run app 
Change app 


Ov-adlc dy\d ^oojlc sometimes 

*tV)CiV" URLs. |-f *t^csc 
URLs work, do a 



http:/ / www. oracle, com/technetwork/java/javase/downloads/index, html 


then install Android Studio 

Once you have Java up and running, you can download Android 
Studio from here: 


l-P i\\\s URL lias 

scavdii -fov* Andv*oid S*tudio m 


dcvcloPcv*air>dv-o*iddom. 

I 


https:/ / developer, android, com/sdk/installing/index, html?pkg—studio 


This page also includes installation instructions. Follow the instructions 
to install Android Studio on your computer. Once you’ve installed 
Android Studio, open it and follow the instructions to add the latest 
SDK tools and support libraries. 


When you’re done, you should see the Android Studio welcome screen. 
You’re ready to build your first Android app. 


1/VcVc mdlud'mj mstalla 七 ion 

ms-tvud-tio^s \y\ 七 his book as 七 hey yt 

ou 七 0 ( dait pretty <\uitkly. Follow ihc 
onlme *msi\rudiioK>s av\d you II be -f mc. 


TV^'is is 

f[v\dyo\d Studio 
y/cldomC 

I*b 

'm^ludics d sc*t 

(Jc oft»o\r\S -fo\r 
you 
do. 
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Android Studio Setup 



Welcome to Android Studio 


Recent Projects 


No Project Open Yet 


Quick Start 


Start a new Android Studio project 
- Open an existing Android Studio project 








getting started 


You say we’re going to use 
Android Studio to build the Android 
apps. Do I have to? 

Strictly speaking, you don’t have to 
use Android Studio to build Android apps. 
All you need is a tool that will let you write 
and compile Java code, plus a few other 
specialist tools to convert the compiled 
code into a form that Android devices can 
run. 

So I can use my own IDE? 

Android Studio is the official Android 
IDE, but Eclipse is also popular. You can 
see further details here: https://developer. 
android, com/tools/sdk/eclipse-adt.html. 



Can I write Android apps without 
using an IDE? 

It's possible, but it's more work. Most 
Android apps are now created using a build 
tool called gradle. Gradle projects can be 
created and built using a text editor and a 
command line. 

A build tool? So is gradle like 

ANT? 

Similar, but gradle is much more 
powerful than ANT. Gradle can compile and 
deploy code, just like ANT, but it also uses 
Maven to download any third-party libraries 
your code needs. Gradle also uses Groovy as 
a scripting language, which means you can 
easily create quite complex builds with gradle. 


Most apps are built using gradle? I 
thought you said a lot of developers use 
Android Studio? 

Android Studio provides a graphical 
interface to gradle, and also to other tools 
for creating layouts, reading logs and 
debugging. 


Puild a basic app 


Now that you’ve set up your development environment, you’re 
ready to create your first Android app. Here’s what the app will 
look like: 


This is the 

the applidatioh. 



S simple 


This is d 

app, but thats all 
的 ccd -Po\r you\r vcv*y 

f ’Hrst A^dvoid app. 


you 
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create project 

Lefs build the basic app 


)U VC 


y>ov/, so 


domflcicd this s*tcP 
> y/c ； vc tidked *i*t o^+. 


Whenever you create a new app, you need to create a new 
project for it. Make sure you have Android Studio open, 
and follow along with us. 



Set up environment 
Build app 
Run app 
Change app 


1. Create a new project 

The Android Studio welcome screen gives you a number of 
options for what you want to do. We want to create a new project, 
so click on the option for “Start a new Android Studio project”. 



you dvca-tc 

will appear This is ou\r 
•f i\rsi p\rojcdt, so 七 his area is 
tuv-v-c^tly cmp-ty. 
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building a basic app (continued) 


Z. Configure the project 

You now need to configure the app by saying what you want to 
call it, what company domain to use, and where you would like 
to store the files. 


Android Studio uses the company domain and application name 
to form the name of the package that will be used for your app. 
As an example, if you give your app a name of “My First App’’ 
and use a company domain of “hfad.com”，Android Studio will 
derive a package name of c om. hf ad. my first app. The 
package name is really important in Android, as it’s used by 
Android devices to uniquely identify your app. 

Enter an application name of “My First App”，a company name 
of “hfad.com”，and accept the default project location. Then 
click on the Next button. 



getting started 

Set up environment 
Build app 
Run app 
Change app 


WatcK it! 


The package 
name must 
stay the same 
for the lifetime 
of your app. 


It’s a unique identifier for your 
app and used to manage 
multiple versions of the same 
app- 


The v/izavd -fov-ms 

七 lie ir>amc 

by *tV>c 

affiliation 

diomdm- 


Create New Project 


L 




New Project 

Android Studio 


Configure your new project 


The hame is shovm 

•m the google Play S-tov-c 

敬 ioiAS othc\r places, -fcoo. 


Application name: 
Company Domain: 
Package name: 
Project [ocation: 





/\11 of k your W\W be stored ke. 
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api level 


Puildiwg a basic app (continued) 

3 . Specify the API level 



Set up environment 
Build app 
Run app 
Change app 


You now need to indicate which API level of Android your app will use. 
API levels increase with every new version of Android. Unless you only 
want your app to run on the very newest devices, you probably want to 


specify one of the older APIs. 

Here, we’re choosing API level 15, which means it will be able to run on 
most devices. Also, we’re only going to create a version of our app to run 


You 11 sec about 
API levels oy\ fay. 


on phones and tablets, so we’ll leave the other options unchecked. 


When you’ve done this, click on the Next button. 


mmirwum VC^uiV^cd 
is 七 he lo>wcs*t vcv-s*ior> youv 
aff Will suffovt- * 一 ^ 

v/'ill v\ay\ oy> divides W\{\\ 

•this level API or hi^cv-. |*t 

v/oy >’ 七 vur> oy\ dcvidcs >wrth 
a lov/cv API- 
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getting started 


^nivcbli Versions Up Cl^se 


You’ve probably heard a lot of things about Android that sound tasty. Things like 
Ice Cream Sandwich, Jelly Bean, KitKat, and Lollipop. So what’s with all the 
confectionary? 



Android versions have a version number and a codename. The version number gives 
the precise version of Android (e.g., 5.0), while the codename is a slightly more generic 
‘friendly” name that may cover several versions of Android (e.g., Lollipop). The 
API level refers to the version of the APIs used by applications. As an example, the 


Version 

Codename 

API level 

1.0 


1 

1.1 


2 

1.5 

Cupcake 

3 

1.6 

Donut 

4 

2.0 

Eclair 

5 

2.01 

Eclair 

6 

2.1 

Eclair 

7 

2.2.x 

Froyo 

8 

23-2.3.2 

Gingerbread 

9 

2.3.2-2.3.7 

Gingerbread 

10 

3.0 

Honeycomb 

11 

3.1 

Honeycomb 

12 

3.2 

Honeycomb 

13 

4.0 - 4.0.2 

Ice Cream Sandwich 

14 

4.0.3-4.0.4 

Ice Cream Sandwich 

15 

4.1 

Jelly Bean 

16 

4.2 

Jelly Bean 

17 

4.3 

Jelly Bean 

18 

4.4 

KitKat 

19 

4.4 

KitKat (with wearable extensions) 

20 

5.0 

Lollipop 

21 


ttairdly dhyohC uses 
these vc\rsiohS. 


y 


Most devices use 
OY\t of -bKcsc APIs. 


When you develop Android apps, you really need to consider which versions of 
Android you want your app to be compatible with. If you specify that your app is only 
compatible with the very latest version of the SDK, you might find that it can’t be run 
on many devices in the first instance. You can find out the percentage of devices running 
particular versions here: https://developer.android.com/about/dashboards/index.html. 
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50,000 feet 


Activities awd layouts from 50,000 feet 

The next thing you’ll be prompted to do is add an activity to your project. 
Every Android app is a collection of screens, and each screen is comprised 
of an activity and a layout. 


An activity is a single, defined thing that your user can do. You 

might have an activity to compose an email, take a photo, or find a contact. 
Activities are usually associated with one screen, and they’re written in Java. 


A layout describes the appearance of the screen. Layouts are written 
as XML files and they tell Android how the different screen elements are 
arranged. 

Let’s look in more detail at how activities and layouts work together to 
create a user interface: 



Set up environment 
Build app 
Run app 
Change app 


Layouts cteiine kow 


tke user interface is 
presentect. 

Activities cteiine 
actions. 



The device launches 
your app and creates 
an activity object. 



The activity object 
specifies a layout. 



The activity tells 
Android to display the 
layout on screen. 



O 

O 

o 

e 


The user interacts 
with the layout thats 
displayed on the device. 

The activity responds 
to these interactions by 
running application code. 

The activity updates 
the display... 

...which the user sees 
on the device. 



Now that you know a bit more about what activities and layouts are, 
let’s go through the last couple of steps in the wizard and get it to 
create a basic activity and layout. 
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Puildiwg a basic app (continued) 



getting started 

Set up environment 

Build app 
Run app 
Change app 


4. Create aw activity 

The next screen gives you a series of templates you can use to 
create an activity and layout. You need to choose one. We’re 
going to create an app with a basic activity and layout, so 
choose the Blank Activity option and click the Next button. 



a\rc types <A 

-(■\row>) bu"t siaV*c you 
select BUk A^Wrty 
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configure activity 


Puildiwg a basic app (continued) 

5 . Configure the activity 



Set up environment 
Build app 
Run app 
Change app 


You will now be asked what you want to call the screen’s activity 
and layout. You will also need to say what the title of the screen will 
be, and specify a menu resource name. Enter an activity name of 
c 'MainActivity ?? , and a layout name of “activity—main”. The activity is 
a Java class, and the layout is an XML file, so the names we’ve given 
here will create a Java class file called MainActivity.java and an XML file 
called activity_main. xml. 

When you click on the Finish button, Android Studio will build your 
app. 


Create New Project 



Choose options for your new file 



Creates a new blank activity with an action 
bar. 


Activity Name: 
Layout Name: 


Title 


Menu Resource Name: menu main 


ar\d layou-t a 

dc-faul-b 

(or o*t^c\r options. 
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You've just created your first Android app 

So what just happened? 



getting started 

Set up environment 

Build app 
Run app 
Change app 


o 

o 


The Android Studio wizard created a project for your app, 
configured to your specifications. 

You defined which versions of Android the app should be compatible with, and 
the wizard created all of the files and folders needed for a basic valid app. 

It created a basic activity and layout with template code. 

The template code includes layout XML and activity Java code, with sample 
“Hello world!” text in the layout. You can change this code. 


When you finish creating your project by going through the wizard, 
Android Studio automatically displays the project for you. 

Here’s what our project looks like (don’t worry if it looks 
complicated right now, we’ll break it down over the next few pages): 


This is 七 ) e ih Ahdv-oid SW_ 

/ 


e o o 

Q activity 一 main .xml - [app] - My First App - [-/AndroidStudioProjects/MyFirstApp] 


Q A C5 0 

SM ( | V 丨招 I ; app ▼ I ►你 Ct l=n ^ ^ □ W \ 7 \ 


MyFirslApp Cjapp tl sre 

- g t /- / 

Ci main CS res layout <> activity_main.xml 



*-> 


•ffi Android 


c MainActivityjava x o activity 一 main.xml x 


2 ▼ 
Q_ 

01 


2 

u 

3 

M 

V 


► 


raapp 

► 亡 ] manifests 

▼ java 

▼ El com.hfad.myfirstapp 

c *b MairvActivity 

► El com.hfad.myfirstapp 

▼ Cires 

► IDdrawable 

▼ El layout 

<> activity_main.xml 

► El menu 

► Rvalues 
(s) Cradle Scripts 




Palette 

睾 ▼ 卜 [!▼ ! El Nexus 4^ if 

▼ jAppTheme Main Activity^ 

Component Tree 


Cl Layouts 

: ， 喝， 2 卜 


▼ _ Device Screen 

3 

-Q 


FrameLayout 

]LinearLayout (Horizonte 
]LinearLayout (Vertical) 
TableLayout 
目 TableRow 
西 Grid Layout 
团 Relative Layout 
Cl Widgets 
|Ab| Plain TextView 
@ Large Text 
|Ab| Medium Text 
@ Small Text 
ok Button 
o. Small Button 
O 1 RadioButton 
MCheckBox 
a Switch 
ToggleButton 
鼦 ImageButton 
B ImageView 
_ ProgressBar (Large) 

一 ProgressBar (Normal) 
™ ProgressBar (Small) 

麵 ProgressBar (Horizonta 
•o* SeekBar 
★ RatingBar 
i^i Spinner 
d WebView 
t| Text Fields 
Plain Text 
[T Person Name 
【 Password 

Design Text 


0E 


1S1 Relative Layout 


2 . 


lAblTextView - @string/hello_world 






Properties ? t> 

layoutheight match_parent 
style 

accessibilityLiveRec 

alpha 

background 

backgroundTint 

backgroundTintMoi 

clickable 

contentDescription 

elevation 

focusable 

focusablelnTouchM □ 

► gravity [] 

id 


固 Terminal 0: Messages p 6: Android 嘴 TODO Event Log [F| Cradle Console 

li Memory Monitor 

Cradle build finished in 24 sec (49 minutes ago) 


n/a 

n/a 
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folder sfrucfure 


Android Studio creates 
a complete folder structure for you 



Set up environment 
Build app 
Run app 
Change app 


An Android app is really just a bunch of valid files in a particular folder structure, 
and Android Studio sets all of this up for you when you create a new app. The 
easiest way of looking at this folder structure is with the explorer in the leftmost 
column of Android Studio. 


The explorer contains all of the projects that you currently have open. To expand 
or collapse folders, just click on the arrows to the left of the folder icons. 


Choose *tV^c 
project of*tio\r\ 
iicvc *to see 
-files and -foldcv-s 
make uf 
yoviV" project 

This is the 
o-p the 
proj 比 t. 


BOO 


CD 



m 0 ； 

MyFirstApp 

Ep Project 


K 3 & 



o ^ 


3 

w 

h 

r^l 


Cll^k OY\ 

•biicsc av-\roy/s 
•bo c%fair\di ov- 
tollafsc i\\t 
•folders. 



These -files 
-foldcvs 
a\rc all 
mduded ih 
youv- pv-ojedi. 


rg| 




MyFirstApp /AndroEdStydEoPrqjects/M^ 


Q .idea 

向 app 

► DbuiiltJ 
D fibs 
▼ D sre 

► tl anrfroitJTest 
▼ D main 
T t java 

T B com.hfad.myfrstapp 
c b MainActivity 

▼ Cares 

E drawable 
B layout 

。 activitv_main.xml 
& menu 

1 ^ mipmap-hdpi 
^ mipmap-mdpi 
E mipmap-xhdpi 
E mipmap-Kxhdpi 
1 ^ values 

S values-wAZOdp 
AntJroidMa nifest. xml 
El .gitignore 
5 appJmi 
5 build.gradlE 
El proguard-rules.pro 
D grad I e 
0 .gitignore 
build.gradle 
[jll gracfle.properties 
@ grad lew 
@ gradlew.bat 
■31 local-properties 
MyFirstApp Jml 
settings.gratJle 


J 



The folder structure includes different 
types of files 

If you browse through the folder structure, you’ll see 
that the wizard has created various types of files and 
folders for you: 


o 

o 

o 



Java and XML source files 

These are the activity and layout files the 
wizard created for you. 


Android-generated Java files 

There are some extra Java files you don’t 
need to touch which Android Studio 
generates for you automatically. 


Resource files 

These include default image files for 
icons, styles your app might use, and any 
common String values your app might 
want to look up. 

Android libraries 

In the wizard, you specified the minimum 
SDK version you want your app to be 
compatible with. Android Studio makes 
sure it includes the relevant Android 
libraries for this version. 



Configuration files 

The configuration files tell Android what’s 
actually in the app and how it should run. 


Let’s take a closer look at some of the key files and 
folders in Androidville. 
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Useful files m your project 

Android Studio projects use the gradle build system to compile and 
deploy your apps. Gradle projects have a standard layout. Here are 
some of the key files and folders you’ll be working with: 



getting started 

Set up environment 

Build app 
Run app 
Change app 


□ 


The root folder 
has the same name 
as your project. 



app 


□ 


The build/ folder contains files 
that Android Studio creates 
•for you. You don’t usually edit 
anything in this folder. 


build 



generated 


The sre/folder contains 
source code you write 
and edit. 




Every Android project 
needs a file called 
R.jovo, which is 
created for you and it 
lives in the generated 
folder. Android uses it 
to help it keep track 
of resources in the 
app. 


The java/folder contains 
any Java code you write. Any 
activities you create live here 


You can find system resources 
in the res/folder. The layout/ 
folder contains layouts, and 
the values/ folder contains 
resource files for values such 
as strings. You can get other 
types of resources too. 


Every Android app must include a 
file called AndroidManifest.xml 
at its root. The manifest file 
contains essential information 
about the app, such as what 
components it contains, required 
libraries, and other declarations. 


com.hfad.myfirstapp 


o 


com. hfad. myfirstapp 

I^ 


□ 


lelatt F««{l 

a 


MainActivity.java 


R.java 

Main A cti vi ty.java defines 
an activity. An activity tells 
Android how the app should 
interact with the user. 


res 


layout ~k 

<%ml> I 

activity_main.xml 


activify_moin.xmI defines a 
layout. A layout tells Android 
how your app should look. 


□ 

values 

I 


jes — k 


<Arwl>| 


strings.xml 


strings.xml contains string id/ 
value pairs. It includes strings 
such as the application name and 
any default text values. Other 
files such as layouts and activities 
can look up text values from here. 


AndroidManifest.xml 
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meet the editors 


app 


钵 Cl ， 薛丨 $ l s 奋 


MyFirstApp app D src Q main - res 

f Project ▼! ❽ + I 


MyFirstApp (-/AndroidStudioProjeas/ 

► Cl .idea 
▼ Qgapp 

► Q build 
Cl libs 
▼ CD src 

► ClandroidTest 
▼ t] main 

▼ tijava 

▼ E] com.hfad. 

c % MainActivity 

▼ Cfires 

E] drawable 

▼ E] layout 

<> activity 一 main.xml 

► E] menu 

► E] mipmap-hdpi 

► E] mipmap-mdpi 

► E] mipmap-xhdpi 

► E] mipmap-xxhdpi 

► Rvalues 

► E] values-w820dp 
^ AndroidManifest.xml 

@ .gitignore 
91 app.iml 
(? build.gradle 
[i proguard-rules. 

► D gradle 
@ .gitignore 
(5 build.gradle 
[d\ qradle.properties 


Q layout <> activity_main.xml 
c Main Activity java x ■ activity_main.xml x 



Palette ♦ ， I— 

Layouts MainActivity^ 

]FrameLayout 同， 

LinearLayout (Horizonte “ 

I I LinearLayout (Vertical) 

TableLayout 
固 TableRow 
GridLayout 
园 Relative Layout 
D Widgets 
(Abl Plain TextView 
|Ab| Large Text 
|Ab| Medium Text 
@ Small Text 
以 Button 
oy Small Button 
RadioButton 
!✓! CheckBox 
■ Switch 


Tiicsc av-c 

views o-f 
*tV^c same 

f»i c . 

-f'lV-S-t View 
s)ioy/s 
Code, 
ar\d 
sctor\d 
view sV^oy/s 
■b^c dcs'i^. 



❸ O O 
_ 

a m ^ 


activity main.xml - [app] - MyFirstApp - [-/AndroidStudioProjects/MyFirstApp 


® d* i ^ S 


铲 iin 




IL 




•P' 


Cjj MyFirstApp ^3 app tl src Q main ^ res 

Project ▼ © + I— 


o 

5 1 

^1 

m 


u 

3 

U 

3 

r^l 

V 


C 3 MyFirstApp (〜 /AndroidStudioProjects/ 

► D.idea 
▼ d ； app 
► D build 
dibs 
▼ C] src 

► D androidTest 
▼ C] main 
▼ tljava 

▼ El com.hfad.myfirstapp 
c MainActivity 

tires 

£] drawable 
ED layout 

<> activity_main.xml 
E] menu 

E] mipmap-hdpi 
El mipmap-mdpi 



'▲贫 Q5' app 3 ►你 
layout o activity_main.xml 
c Ma'nActivity.java x <y activity_main.xml x 

(=)|4telativeLayout xmlns : and roid="http: //schemas.android. co<n/apk/res/an] 
xmlns: tools="http: //schemas.android.com/tools" android: layout 一 wj 
android: layout_height="match_pa rent" android: paddingLeft ： 
android :paddingRight="@dimen/activity_horizontal_inargin" 
android :paddingTop="@dimen/activity_vertical_niargin ,> 
and roid :paddingBotton= ,, @din)en/activity_vertical_inargin ,> tools: coni 

〈TextView and roid : text= M @st ring/hello_world" android: layout 
(§1 and roid : layout_height= ,, wrap_content" /> 

l|)</RelativeLayout> 


...ar\d *t^c -file 
appeav" m cdi'to'r 


© o o 


activity 一 main .xml - [app】-MyFirstApp - [-/AndroidStudioProjects/MyFij 




The code editor 

Most files get displayed 
in the code editor. The 
code editor is just like a 
text editor, but with extra 
features such as color 
coding and code checking. 


Poublc-dlidk oh the 
•Pile ih the cxplov-cv-... 


The design editor 

If you’re editing a 
layout, you have an 
extra option. Rather 
than edit the XML, you 
can use the design 
editor. The design 
editor allows you to 
drag GUI components 
onto your layout, and 
arrange them how you 
want. The code editor 
and design editor give 
different views of the 
same file, so you can 
switch back and forth 
between the two. 


18 Chapter 1 


Edit code with the Android Studio editors 

You view and edit files using the Android Studio editors. Double¬ 
click on the file you want to work with, and the file contents will 
appear in the middle of the Android Studio window. 


\/ 


Run app 
Change app 


safojd :T £ 鑛 3J3 unhs :Z V 


ss!JO>ru.:fNI * slu.!3J(d> PHnCQ I 貫 
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% 


+ 


峽 V 


繫 U 費，办 

+ 


Here’s the code from a layout file Android Studio generated for us. 
We know you’ve not seen layout code before, but just see if you can 
match each of the descriptions at the bottom of the page to the 
correct lines of code. We’ve done one to get you started. 


activity_main.xml 

<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android M 

xmlns : tools="http :// schemas.android.com/tools" 

android:layout—width= n match— parent" 

android: layout__height= M match_parent n 

android:paddingLeft= M 16dp" 

android:paddingRight= M 16dp" 

android:paddingTop="16dp" 

android:paddingBottom="16dp" 

tools : context= M .MainActivity"> 


<TextView 



Add padding to the screen 
margins. 


Display the value of a string 
resource called 
hello world. 


Include a TextView GUI 
component for displaying 
text. 


Make the layout the same 
width and height as the 
screen size on the device. 


Make the text wrap 
horizontally and vertically. 


you are here ► 
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▼ + 


+ 




Here’s the code from a layout file Android Studio generated for us. We 
know you’ve not seen layout code before, but just see if you can match 
each of the descriptions at the bottom of the page to the correct lines 
of code. We’ve done one to get you started. 


activity_main.xml 

<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 



20 Chapter 1 









getting started 


% 老 + 

• + 

Now let’s see if you can do the same thing for some activity code. 

This is example code, and not the code that Android Studio 
will have generated for you. Match the descriptions below to the 
correct lines of code. 


MainActivity.java 

package com.hfad.myfirstapp; 

import android.os.Bundle; 
import android.app.Activity; 

public class MainActivity extends Activity { 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 


This is the package name. 


These are Android classes 
used in MainActivity. 


Implement the onCreate () 
method from the Activity 
class. This method is called 
when the activity is first 
created. 


Specifies which layout to use. 


MainActivity extends the 
Android class 

android.app.Activity. 


you are here ► 


21 







another so/Won 


% 老 + 

• + 鬌备 

Now let’s see if you can do the same thing for some activity code. 

This is example code, and not the code that Android Studio 
will have generated for you. Match the descriptions below to the 
correct lines of code. 


MainActivity.java 
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Run the app m the Android emulator 

So far you’ve seen what your Android app looks like in Android 
Studio and got a feel for how it hangs together. But what you 
really want to do is see it running, right? 


You have a couple of options when it comes to running your 
apps. The first option is to run them on a physical device. But 
what if you don’t have one to hand, or you want to see how it 
looks on a type of device you don’t have? 

An alternative option is to use the Android emulator that’s 
built into the Android SDK. The emulator enables you to set up 
one or more Android virtual devices (AVDs) and then run 
your app in the emulator as though it’s running on a physical device. 


So what does the emulator look like? 

Here’s an AVD running in the Android emulator. It looks just 
like a phone running on your computer. 



getting started 

Set up environment 

Build app 
Run app 
Change app 


Tke Anctroict emulator allows 
you to run your app on an 
Anctroict virtual device (AVD). 
Tke AVD beltaves just like a 

pkysical Anctroict device. You 
can set up numerous AVDs, 
eack emulating a diHerent 
type ol device. 


The emulator is an application 
that re-creates the exact hardware 
environment of an Android 
device: from its GPU and memory, 
through to the sound chips and 
the video display. The emulator is 
built on an existing emulator called 
QEMU, which is similar to other 
virtual machine applications you 
may have used, like VirtualBox or 
VMWare. 

The exact appearance and 
behavior of the AVD depends on 
how you’ve set up the AVD in the 
first place. The AVD here is set up 
to mimic a Nexus 4, so it will look 
and behave just like a Nexus 4 on 
your computer. 

Let’s set up an AVD so that you 
can see your app running in the 
emulator. 



Ov\U you vc sc*t uf 
^ hVV, you tan see 
youV- dff \ruir\ir\'m5 ov\ it 
A^dvo'id S*Ud’》o lau^cs 
i\\t cmula-bov- -fov- you. 


Jus-t like a physical 
phohe ； you heed -to 

unlock it before 



you siari usihg ii 
Simply dick oh the 
lodk ifioh 3hd dv*d0 
it upward. 
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create avd 


Creating an Android Virtual Pevice 

There are a few steps you need to go through in order to set up an 
AVD within Android Studio. We’ll set up a Nexus 4 AVD running API 
level 21 so that you can see how your app looks and behaves running 
on this type of device. The steps are pretty much identical no matter 
what type of device you want to set up. 


\/ 

\/ 


Set up environment 
Build app 
Run app 
Change app 


Open the Android Virtual Pevicc Manager 

The AVD Manager allows you to set up new AVDs, and 
view and edit ones you’ve already created. Open it by 
selecting Android on the Tools menu and choosing AVD 
Manager. 

If you have no AVDs set up already, you’ll be presented 
with a screen prompting you to create one. Click on the 
“Create a virtual device” button. 

Clitk or^ u Cvca*tc a viv-tual 

butto 灼 *to an A\/P 


I 0 o e 




AVD Manager 


1 


Your Virtual Devices 


Android Studio 



Select the 
hardware 

On the next screen, 
you’ll be prompted 
to choose a device 
definition. This is 
the type of device 
your AVD will 
emulate. You can 
choose a variety of 
phone, tablet, wear, 
or TV devices. 

We’re going to see 
what our app looks 
like running on 
a Nexus 4 phone. 
Choose Phone from 
the Category menu 
and Nexus 4 from 
the list. Then click 
the Next button. 
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getting started 

Set up environment 

Build app 
Run app 
Change app 


Select a system image 

Next, you need to select a system image. The system image gives you an 
installed version of the Android operating system. You can choose the 
version of Android you want to be on your AVD, and what type of GPU 
(ARM or x86). 

You need to choose a system image for an API level that’s compatible 
with the app you’re building. As an example, if you want your app to 
work on a minimum of API level 15, choose a system image for at least 
API level 15. We’re going to use a system image for API level 21. Choose 
the option for Lollipop 21 armeabi-v7a with a target of Android 5.0.1. 
Then click on the Next button. 


Creating m AVI? (continued) 


v/ 


I e o 


Virtual Device Configuration 


L 


System Image 

Select a system image 


you doh’t have 
this system ― ^ 

… stalled，youll be 
givch the option -to 

dov/hload i-fc. 


Release Name 

API Level 

ABI 

Target 

KitKat Wear 

KitKat Wear 

L 

armeabi-v7a 

x86 

Android L (Previi 

Android L (Previi 

Lollipop 

21 

armeabi-v7a 

Android 5.0.1 

Lollipop 

21 

armeabi-v7a 

Google APIs (Co 

Lollipop 

21 

x86 

Google APIs (Co 

Lollipop 

21 

x86_64 

Android SDK Pla 

Lollipop 

21 

x86 

Android SDK Pla 

Lollipop 

21 

x86 一 64 

System Image x 

KitKat 

19 

armeabi-v7a 

Android 4.4.2 

KitKat 

19 

x86 

Android 4.4.2 

1^1 Show downloadable system images 

d 


Lollipop 



API Level 

21 

Android 

5.0.1 

Android Open Source 
Project 


System Image 

armeabi-v7a 

- See documentation for Android 5 APIs 


Cancel 


Previous 


Next 


Finish 


We’ll continue setting up the AVD on the next page. 
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check configuration 


Set up environment 
Build app 
Run app 
Change app 

Verify the AYP configuration 

On the next screen, you’ll be asked to verify the AVD configuration. This screen 
summarizes the options you chose over the last few screens, and gives you the 
option of changing them. Accept the options, and click on the Finish button. 


Creating m AVI? (continued) 


\/ 

\/ 



The AVD Manager will create the AVD for you, and when it’s done, display it in 
the AVD Manager list of devices. You may now close the AVD Manager. 


BOO 

AVD Manager | 

l - Your Virtual Devices 

Android Studio 
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Ruw the app m the emulator 

Now that you’ve set up your AVD, let’s run the app on it. To do 
this, choose the “Run ‘app’’’ command from the Run menu. When 
you’re asked to choose a device, make sure the “Launch emulator” 
option is selected, along with the Nexus 4 AVD you just created. 
Then click on the OK button. 

While we wait patiently for the AVD to appear, let’s take a look at 
what happens when you choose Run. 

Compile, package, deploy and run 

Choosing the Run option doesn’t just run your app. It also deals 
with all the preliminary tasks that are needed for the app to run: 





Libraries Resources 



Java file 


Bytecode 


APKfile 


\/ 

V 


©GO 


getting started 

Set up environment 

Build app 
Run app 
Change app 


Choose Device 


Choose a irunning device 


Nothing to show 


■ Launch emylator 
Android virtual device. 


Use same devke for fui jre [aunches 



Nexus 4 API 21 



This is *tKc v/c jus 七 dvca*tcd 




B 

Emulator 


An APK iile is an 
Android application 

package. It’s 
)asically a JAR 
or ZIP Iile lor 

Android applications. 


Emulator 


o 

O 

o 


The Java source files get compiled to 
bytecode. 

An Android application package, or APK 
file, gets created. 

The APK file includes the compiled Java files, 
along with any libraries and resources needed 
by your app. 

Assuming there's not one already 
running, the emulator gets launched 
with the AVD. 


o 


Once the emulator has been launched 
and the AVD is active, the APK file is 
uploaded to the AVD and installed. 



The AVD starts the main activity 
associated with the app. 

Your app gets displayed on the AVD screen, 
and it’s all ready for you to test out. 


you are here ► 
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be patient 




4: Run 

% TODO 6: Android 固 Terminal |r=- 0: Messages Event Log E Gradle Console 

Memory Monitor 


Cradle build finished in 2 sec (56 minutes ago) 

19:1 

n/a 

n/a 



Here’s the output from our console window when we ran our app: 



A^civ'oid "the d^ul 3 "to\r y/i 七 h 

MV Nexus 午，七 he A\/D wc jus-t sc*t up. 


Waiting for device. 

/Applications/adt-bundle-mac/sdk/tools/emulator -avd Nexus_4 一 API—21 -netspeed full -netdelay none 
Device connected: emulator-5554 

Device Nexus_4_API_21 [emulator-5554] is online, waiting for processes to start up.. 

Device is ready: Nexus_4—API_21 [emulator-5554] Al/D is up 


3hd \ruhhihj. 


Target device : Nexus_4 一 API—21 [emulator-5554] 

Uploading file 

local path : /Users/dawng/AndroidStudioProjects/MyFirstApp/app/build/outputs/apk/app-debug.apk 
remote path : / data/local/tmp/com.hfad.myfirstapp 
Installing com.hfad.myfirstapp 

DEVICE SHELL COMMAND : pm install -r "/data/local/tmp/com.hfad.myfirstapp" 
pkg: / data/local/tmp/com.hfad.myfirstapp 
Success 

Launching application : com.hfad.myfirstapp/com.hfad.myfirstapp.MainActivity. 

DEVICE SHELL COMMAND : am start -n "com.hfad.myfirstapp/com.hfad.myfirstapp.MainActivity" -a 
android.intent.action.MAIN -c android.intent.category.LAUNCHER 

Starting: Intent { act=android.intent•action.MAIN cat=[android.intent.category.LAUNCHER] 
cmp=com.hfad.myfirstapp/.MainActivity } 


Unload a^di ms-tall 


Finally, ou\r app is laughed by s-ta\rt*mg -the mam adiiviiy 
•Po\r it This is 七 he aciiviiy ihc wiz^d Crcaicd (or us. 
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You caw watch progress in the console 

It can sometimes take quite a while for the emulator to launch with your 
AVD — often several minutes. The great news is that you can see what’s ， 
happening using the Android Studio console. The console gives you a 
blow-by-blow account of what the gradle build system is doing, and if it 
encounters any errors, you’ll see them highlighted in the text. 

You can find the console at the bottom of the Android Studio screen: 


\/ 

\/ 


Set up environment 
Build app 
Run app 
Change app 


% su 99 cs "t sorwethihg else -fco do 

while waitihg the cmula-tov b> stavt 
Like or ^ookihj a sr^all wxtal 


^l a _I 3 e 

□O' E I y X ” 


3 - 3133 bnr 

















Test drive 


So let’s look at what actually happens on screen when you 
run your app. 



getting started 

Set up environment 

Build app 
Run app 
Change app 


First, the emulator fires up in a separate window. The 
emulator takes a while to load the AVD, but then after a bit 
you see the locked screen of the AVD. 



you are here ► 


Tiic cw>ula*tov -〜 ^ 


••丄 ahd heve S the locked Al/D. 
I 七 ahd behaves just like 
a ireal A/exus 午 devi^. 


e o 


5554:Nexus 4 API 21 


5554:Nexus 4 API 21 


android 


5554:Nexus 4 API 21 


Hello world! 


This 


the 


is 


"title of the 
appliWioh. 


Hcv-cs tV^c 




七 he y/'iz 3 \rd 


tv-ca*tcd -fo\r 


He o wor d! 


When you unlock the AVD screen by 
swiping the padlock icon upward, you see 
the app you just created. The application 
name appears at the top of the screen, and 
the default sample text “Hello world!” is 
displayed in the screen. 


y\^dvoidi S*tudiio "LViC 

sample u Hcllo y/ovldf w (or us 

us *to *bcll 


Here’s 
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what happened 


What just happened? 


Let’s break down what happens when you run the app: 



Set up environment 
Build app 
Run app 
Change app 


O 

o 

o 

o 


Android Studio launches the emulator, 
loads the AVD # and installs the app. 


When the app gets 
launched, an activity 
object is created from 
MainActivity.java. 

The activity specifies 
that it uses the layout 
activity 一 main • xml • 

The activity tells Android to 
display the layout on the screen. 

The text “Hello world!” gets displayed. 



\y\ -tK'is fav-tidulav- 
a virtual dcv'idc- 


tWei^re ng o 

Dumb Questi9ns 


You mentioned that when you create an APK file, the 
Java source code gets compiled into bytecode and added to 
the APK. Presumably you mean it gets compiled into Java 
bytecode, right? 

It does, but that’s not the end of the story. Things work a little 
differently on Android. 

The big difference with Android is that your code doesn’t actually 
run inside an ordinary Java VM. It runs on the Android runtime 
(ART) instead, and on older devices it runs in a predecessor to 
ART called Dalvik. This means that you write your Java source 
code, compile it into .class files using the Java compiler, and then 
the .class files get stitched into a single file in DEX format, which is 
smaller, more efficient bytecode. ART then runs the DEX code. You 
can see more details about this in Appendix A. 


That sounds complicated. Why not just use the normal 
Java VM? 

ART can convert the DEX bytecode into native code that can 
run directly on the CPU of the Android device. This makes the app 
run a lot faster, and use a lot less battery power. 

Is a Java virtual machine really that much overhead? 

Yes. Because on Android, each app runs inside its own 
process. If it used ordinary JVMs, it would need a lot more memory. 

Do I need to create a new AVD every time I create a new 

app? 

No, once you’ve created the AVD you can use it for any of 
your apps. You may find it useful to create multiple AVDs in order 
to test your apps in different situations. As an example, you might 
want to create a tablet AVD so you can see how your app looks and 
behaves on larger devices. 
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Refining the app 

Over the past few pages, you’ve built a basic Android app and 
seen it running in the emulator. Next, we’re going to refine the 
app you’ve built. 

At the moment, the app displays the sample text “Hello world!” 
that the wizard put in for us as a placeholder. You’re going to 
change that text to say something else instead. So what do we 
need to change in order to achieve that? To answer that, let’s 
take a step back and look at how the app is currently built. 


The app has owe activity and owe layout 

When we built the app, we told Android Studio how to 
configure it, and the wizard did the rest. The wizard created a 
basic activity for us, and also a default layout. 




getting started 

Set up environment 

Build app 
Run app 
Change app 



The activity controls what the app does 

Android Studio created an activity for us called 
MainActivity.java. The activity specifies what the app 
does and how it should respond to the user. 



Ouv adtivi-ty 
spcdi-f 'ics 七 he 
aff does dr>d ho>w 
••七 should 

usev - . 


MainActivity.java 


The layout controls the app appearance 

MainA ctivity.java specifies that it uses the layout Android 
Studio created for us called activity—main.xml. The layout 
specifies what the app looks like. 


We want to change the appearance of the app by changing the 
text that’s displayed. This means that we need to deal with the 
Android component that controls what the app looks like. We 
need to take a closer look at the layout. 



0 \ay layou-t spcdi-f ics 

whai ihc app looks 
like. 


activity—main.xml 


you are here ► 
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the layout 



LirrKffLa^ut (HorizontE 
LinearLayout fVertical) 

)TableLayout 
TableRow 
/Tic rid Layout 
Relative Layout 
j Widgets 
Ab Plain TextView 
Ab! Large Text 
Ab Medium Text 
AbjSmall Text 
ok Button 
ok Small Button 
RadioEutton 


i 负 a 0 0 




▼ 


Whaf s iw the layout? 

We need to change the sample “Hello world!” text that 
Android Studio created for us, so let’s start with the layout 
file activity_main.xml. If it isn’t already open in an editor, open 
it now by finding the file in the app/sre/main/res/layout folder 
in the explorer and double-clicking on it. 


The design editor 

There are two ways of viewing and editing 
layout files in Android Studio: through the 

design editor and through the code editor. 

When you choose the design option, you can see 
that the sample text “Hello world!” appears in 
the layout as you might expect. But what’s in the 
underlying XML? 

Let’s see by switching to the code editor. 


Set up environment 
Build app 
Run app 
Change app 


T\\t 

ed’rtor. 


You see -the desi^h edi-tov 
by dhoosmg hcv-c. 


Hello world! 


n Switch 
ToggleButton 
ImageButton 
^ ImageView 
■■ ProgressBar (Large) 


Desig 


Text 


The code editor 

When you choose the code editor 
option, the content of 
activity—main.xml is displayed. Let’s take 
a closer look at. 
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T\\t todc 〜、 \ / 

edrtov*. 、 


c <> activity- 


Main Activity .java 


<> activity_main.xml 


Prevj 


(^i<RelativeLayout xmlns: and roid="http: //schemas.android.c<xn/apk/res/android" B 
! xmlns ： tools= M http: //schemas.android.com/tools" 

I and roid ： layout_width= M niatch_i>a rent" 

I and roid ： layout_height= M match_f>arent" 

! and roid : paddingLef t= M 16dp" 

I and roid : paddingRight="16dp M 
! android : paddingTop= M 16dp" 
i and roid : paddingBottom= M 16dp M 
tools : context=". MainActivity"> 

0<TextViey 

and roid : text="Hello world!" 

android ： layout_widt h="wrap_content" 

♦ android: layout_height= M wrap_content M /> 

^)</RelativeLayout> 


I Design Text 


To s 找 code cd\ior, d\ck 

° h ih the bo"t"tor^ -tat ， 









































activity_mam.xml has two elements 

Here’s the code from activity—main.xml that Android Studio 
generated for us. 



getting started 

Set up environment 
Build app 
Run app 
Change app 


TVis is 
<Rcla*tivc 
Layou*t> 
element 


// <RelativeLayout xmlns : android= M http :// schemas.android.com/apk/res/android 
xmlns : tools= M http :// schemas.android.com/tools" 
android:layout_width="match—parent" 
android:layout—height= n match—parent" 

... ^ - * A^dv-oid Studio us 


a 

MyFirstApp 


•This is *thc -full pa*th 
3d*ti. 


tools : context= M .MainActivity" > 


more )<ML but 

\jo\A do 灼 ’ *t titt& "to "tWmk 

dbou 七 j uS 七 Y c *t* 


L Q 

app/sre/main 


<TextView 

android:text="@string/hello_world 
android:layout_width= M wrap_content 
android:layout_height= M wrap_content 

</RelativeLayout> 


P ^I 

3 


res 



This is the <Tcxtl/icw> 

nesied withih the 
<RclativcLayou-t> 



layout 


OUl 


activity_main.xml 


The code contains two elements. 

The first element is the <RelativeLayout> 
element. This element tells Android to display items 
on the layout in relative positions. You can use 
<RelativeLayout>, for instance, to center items 
in the middle of the layout, align them to the bottom 
of the screen on your Android device, or position 
them relative to other items. 

The second element is the <TextView> element. 
This element is used to display text to the user. It’s 
nested within the <RelativeLayout>, and in our 
case it’s being used to display the sample text “Hello 
world!’’. 

The key part of the code within the 〈 TextView 〉 
element is the first line. What do you notice? 



Android Studio sometimes 
displays the values of 
references in place of 
actual code. 


As an example, it may display 
"Hello world! n instead of the real code 
"@string/hello_world n . Any such 
substitutions should be highlighted in the code 
editor, and clicking on them or hovering over 
them with your mouse will reveal the true code. 



KlextView 

android ^ text= M Hlello world E" 


android : text="@st ring/hello world H 

b 

己 no rpia : i_n exgin wra p_c on tent; 


T\\t Tc%*t\/ic>w 

clcw>cir\*b 
describes 

layout. 


<TextView 

android :text=”@string/hello—world” iVhal do you hotidc 

android:layout 一 width 二 "wrap—content M about this lihC? 

android:layout height="wrap content" /> 
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strings 


The layout file contams a reference to 
a string, wot the string itself 

The key part of the 〈 TextView〉element is the first line: 

android : text= n @string/hello world" /> 


android : text means that this is the text property of the 
〈Text View 〉 element, so it specifies which text should be displayed in 
the layout. But why does it say 、 '@string/hello world" rather than 
Hello world !”？ What does this actually mean? 


U 


Let’s start with the first part, @ string. This is just a way of telling 
Android to look up a text value from a string resource file. In our case, 
Android Studio created a string resource file for us called strings, xml, 
located in the app/sre/main/res/values folder. 

The second part, hello—world ， tells Android to look up the value 
of a resource with the name hello 一 world. So 

@string/hello_world means “look up the string resource with the 
name hello world, and use the associated text value.” 


Display -the 


Put string values in 
stringfs.xml ratker titan 
kardcoctingf tkem. strings* 
xml is a resource lile 
used to kolct name/value 
pairs ol strings. Layouts 
and activities can look up 
string values usingf tkeir 
name. 

… for S*tv-*m5 v-csou\rdc hello 一 "world. 


android:text= n @string/hello world” /> 


That seems complicated. 

Why doesn't activity—main.xml 
just include the text? Surely 
that's simpler? 


There’s one key reason: localization 

Say you’ve created an app and it’s a big hit on your local Google 
Play Store. But you don’t want to limit yourself to just one country or 
language — you want to make it available internationally and for different 
languages. 

Separating out text values into strings.xml makes dealing with issues like 
this much easier. Rather than having to change hardcoded text values in a 
whole host of different activity and layout files, you can simply replace the 
strings.xml file with an internationalized version. 

Using strings.xml as a central resource for text values also makes it easier 
to make global changes to text across your whole application. If your 
boss needs you to change the wording in an app because the company’s 
changed its name, only strings.xml needs to be changed. 
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getting started 


Lefs look m the striwgs.xml file 

Android Studio created a string resource file for us called 
strings.xml, so let’s see if it contains a hello_world resource. Use the 
explorer to find it in the app/sre/main/res/values folder, and open it by 
double-clicking on it. 

Here’s what our code in the strings.xml file looks like: 

<?xml version="l.0" encoding="utf-8 n ?> 

<resources> 



Set up environment 
Build app 
Run app 
Change app 


___ This is -full 

MyFirstApp 


app/sre/main 


□ 



<string name= M app_name">My First App</string> 

〈string name= M hello_world M >Hello world!</string 〉 

<string name= M action_settings M >Settings</string> 

</resources> S V 丨呼 I mdudes a 

a y\aw>c o-f hello 一咖 "1 气 

As you can see, there’s a line of code that looks just like what we are 3 ^ a value <Jc w ttcllo v/orldf' 
looking for. It describes a string resource with a name of hello_ 
world, and a value of “Hello world !’’： 


res 


LQ 

values 

strings.xml 


<string name= M hello world">Hello world!</string> 


Update strings.xml to change the text 

So let’s change the sample text in the app. If you’ve not already 
done so, find the file strings.xml in the Android Studio explorer, and 
double-click on it to open it. 

Here’s the code from the file. You need to look for the string with 
the name “hello—world”，and change its corresponding text value 
from “Hello world!” to “Sup doge ”： 


<?xml version= M l.0" encoding= M utf-8 M ?> 


<resources> 

<string name 二 n app—name">My First App</string 
〈string name= M hello_world n >fe^W^W^4-d4 - Sup 


> K 

doge</ string> 


value 

w Hcllo 減 IdfUup doy. 


<string name="action_settings n >Settings</string 〉 


</resources 〉 


Once you’ve updated the file, go to the File menu and choose the 
Save All option to save your change. 


you are here ► 
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up close 


String ^esaurce 顶 es Up CjaSe - 

strings, xml is the default resource file used to hold name/value pairs of 
strings so that they can be referenced throughout your app. It has the 
following format: 

-p, <?xml version 二 n l•0 n encoding= M utf-8 M ?> 

’he «rcsouv-(ics> 

eUcht ^<resources> 

<string name= M app_name">My First App</string> 
<string name= M hello_world">Hello world!</string> 
<string name= M action_settings">Settings</string> 
</resources 〉 


•dch-ti-pics -the 

^ov\icv\is o-P 
"the -Pile as 




The <s*br’”> 

v\Bn\t /value 
as s-tv-'mjs. 



There are two things that allow Android to recognize strings.xml as being a 
string resource file: 


XML files held in this folder contain simple values, such as strings and 
colors. 


more <string> elements. 

The format of the file itself indicates that it’s a resource file containing 
Strings. The 〈 resources〉element tells Android that the file contains 
resources, and the <string> element identifies each String resource. 


o The file has a <resources> element, which contains one or 


o The file is held in the folder app/src/main/res/values 


This means that you don’t need to call your String resource file 

strings, xml; if you want, you can call it something else, or split your Strings 

into multiple files. 

Each name/value pair takes the form 


<string name=" string_name M >string_value</ string> 


where string_name is the identifier of the string, and string_value 
is the String value itself. 


A layout can retrieve the value of the String using 


'▼ @ string/ s tring—name '▼ 

r 一 

-tells f[Y\dyo\A b> look for a 
vcsouvtc of *tK*is 


^ - TWiS is of 

s*t\rur\^ y/)iosc V^luC v/C 
y/ar\*t *to V-C*tu\nr\. 
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Take the app for a test drive 

Once you’ve edited the file, try running your app in the emulator 
again by choosing the “Run ‘app’’’ command from the Run 
menu. You should see that your app now says “Sup doge” instead 
of “Hello world!”. 


\/ 

\/ 

\/ 


getting started 

Set up environment 

Build app 
Run app 
Change app 


e ^ 


5S54:Nexus 4 API 21 


Wtrts {Mt 
u^daied version 
o+ ouv app 

m 'the 

cmula-fcov. 


4:41 


First App 


Sup doge p sample text how 

says u Sup dogc^ instead 
o*P w ttcllo world"’. 




D 


tWeiar 

)umb 


e no o 

Questions 


Do I absolutely have to put my text values in a string 
resource file such as strings.xml? 

It's not mandatory, but Android gives you warning messages 
if you hardcode text values. It might seem like a lot of effort at first, 
but it makes things like localization much easier. It's also easier to 
use String resources to start off with, rather than patching them in 
afterward. 

How does separating out the String values help with 
localization? 

Suppose you want your application to be in English by default, 
but in French if the device language is set to French. Rather than 
hardcode different languages into your app, you can have one 
String resource file for English text, and another resource file for 
French text. 


How does the app know which to use? 

Put your default English strings resource file in the app/src/ 
main/res/values folder as normal, and your French resource file in 
a new folder called app/src/main/res/values-fr. If the device is set 
to French, it will use the strings in the app/src/main/res/values-fr 
folder. If the device is set to any other language, it will use the 
strings in app/src/main/res/values. 

The layout code Android Studio generated for me looks a 
little different than the book’s examples. Should I be concerned? 

Android Studio may give you slightly different XML depending 
on which version you’re using. You don’t need to worry about this, 
because from now on you’ll be learning how to roll your own layout 
code anyway, so you'll replace a lot of what Android Studio gives you. 


you are here ► 
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toolbox 



Your Android Toolbox 

You’ve got Chapter 1 under 
your belt and now you’ve 
added Android basic concepts 
to your toolbox. 



BULLET POINTS 


■ 


■ 


Versions of Android have a version 
number, API level, and code name. 

Android Studio is a special version of 
IntelliJ IDEA that interfaces with the 
Android Software Development Kit 
(SDK) and the gradle build system. 

■ A typical Android app is comprised of 
activities, layouts, and resource files. 

■ Layouts describe what your app 
looks like. They’re held in the app/ 
src/main/res/layout folder. 


■ 


Activities describe what you app 
does, and how it interacts with the 
user. The activities you write are held 
in the app/src/main/java folder. 

strings.xml contains string name/ 
value pairs. It’s used to separate 
out text values from the layouts and 
activities, and supports localization. 


you c ^ y \ download 
-full todt -fov- 
i\\t -fv-om 

Wbbps://tmYVAV-Uom/ 
rtcadPtv-stAv'dvoid. 




■ 


■ AndroidManifest.xml contains 
information about the app itself. It 
lives in the app/sre/main folder. 

■ An AVD is an Android Virtual Device. 
It runs in the Android emulator and 
mimics a physical Android device. 

An APK is an Android application 
package. It’s like a JAR file for 
Android apps, and contains your app 
bytecode, libraries, and resources. 
You install an app on a device by 
installing the APK. 

Android apps run in separate 
processes using the Android runtime 
(ART). 

RelativeLayout is used to 
place GUI components in relative 
positions in a layout. 

■ The Textview element is used for 
displaying text. 


■ 


■ 
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2 kmldfng interactive apps 


參 


Apps That Do Something ♦ 



Most apps need to respond to the user in some way. 

In this chapter, you’ll see how you can make your apps a bit more interactive. You’ll see 
how you can get your app to do something in response to the user, and how to get your 
activity and layout talking to each other like best buddies. Along the way, we’ll take you 
a bit deeper into how Android actually works by introducing you to R, the hidden gem 
that glues everything together. 


this is a new chapter 
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beer adviser 


YouYc going to build a Peer Adviser 
app 

In the Chapter 1, you saw how to create a basic app using the 
Android Studio New Project wizard, and how to change the 
text displayed in the layout. But when you create an Android 
app, you’re usually going to want the app to do something. 

In this chapter, we’re going to show you how to create an app 
that the user can interact with: we’ll be creating a Beer Adviser 
app. In the app, users can select the types of beer they enjoy, 
click a button, and get back a list of tasty beers to try out. 

Here’s how the app will be structured: 

o The layout specifies what the app will 
look like. 

It includes three GUI components: 

• A drop-down list of values called a spinner, 
which allows the user to choose which type of 
beer they want. 

• A button that when pressed will return a 
selection of beer types. 



Choose youv 
beev- 


butto 柯 


N^gEER! 


」 Jfil Pale Ale 

… 58Gt Sxcat 

app dorwCS 
up wi 七 h a 
lisi o( bcc\r 
sujjcs-tio^s. 



、 This is >wKa*t 
layout looks like. 


•A text field that displays the types of beer. 



The file strings.xml includes any string 
resources needed by the layout—for 
example, the label of the button 
specified in the layout. 



strings.xml 



The activity specifies how the app 
should interact with the user. 

It takes the type of beer the user chooses, and 
uses this to display a list of beers the user might 
be interested in. It achieves this with the help of a 
custom Java class. 




The custom Java class contains the 
application logic for the app. 

It includes a method that takes a type of beer as a 
parameter, and returns a list of beers of this type. 
The activity calls the method, passes it the type of 
beer, and uses the response. 



Custom Java 
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building interactive apps 


Here's what you need to do 

So let’s get to work and build the Beer Adviser app. There 
are a few steps you need to go through (we’ll tackle these 
throughout the rest of the chapter): 



Create a project. 

You’re creating a brand-new app, so you’ll need to create a new 
project. Just like before, you’ll need to create a basic layout and 
activity. 



Update the layout. 

Once you have a basic app set up, you need to amend the layout 
so that it includes all the GUI components your app needs. 



light 

FINDBEER[ 

Jail Pale Ale 
Gout Stout 



o 

o 


Wire the layout to the activity. 

The layout only creates the visuals. To add smarts to your app, 
you need to wire the layout to the Java code in your activity. 



Write the application logic. 

You’ll add a Java custom class to the app, and use it to make 
sure users get the right beer based on their selection. 



you are here ► 
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create project 


Create the project 

Let’s begin by creating the new app (the steps are similar to 
those we used in the previous chapter): 



Create project 
Update layout 
Connect activity 
Write logic 


o 

O 

o 


Open Android Studio and choose “Start a new Android Studio project” from the 
welcome screen. This starts the wizard you saw in Chapter 1. 

When prompted, enter an application name of “Beer Adviser”，making your 
package name com. hf ad. beeradviser. 

We want the app to work on most phones and tablets, so choose a minimum SDK 
of API 15, and make sure the option for “Phone and Tablet” is ticked. This means 
that any phone or tablet that runs the app must have API 15 installed on it as a 
minimum. Most Android devices meet this criteria. 



Choose a blank activity for your default activity. Call the activity “FindBeerActivity” 
and the accompanying layout “activity_find_beer”. Accept the default values for 
Title and Menu Resource Name, as we won’t be using these. 


Applicatmn name: 
Company Domain; 


Beer Adviser 


hfad.com 


Package name: com.hfad.beeradviser 


Project location: 


\^A Phone and Tabtet 
Mmimurri SDK 


Blank Aaivity 


will take you steps, 

just like bcW. Call you^r apfl.dat.or. 

make Su\rc it uses a SPfC cHr 

API 内 , tell \i ertait a loUk 
tailed a layout called 


Lower API levels target more devices, but have fewer 
features avail able. By targeting API 15 and later, your app 
wifi run on approximately 87,9% of the devices that are 
active on the Coogle Pfay Store. He[p me choose. 


ActEvity Name: 

Layout Name: 

Title: 

Menu Resource Name 
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building interactive apps 


WcVg created a default activity awd layout 

When you click on the Finish button, Android Studio creates a new 
project containing an activity called FindBeerActivity.java and a layout called 
activity_Jind_beer.xml. Let’s start by changing the layout file. To do this, go to 
the app/src/main/res/layout folder, and open the file activity_Jind_beer.xml. 


Just like before, the wizard has created a default layout for us with a “Hello 
world!” <TextView> element on the page like this: 


The layout XML 


□ 

BeerAdviser 

LQ 

app/sre/main 

L LZI 


res 



activity_find_beer.xml 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android' 
xmlns : tools=，'http : / /schemas . android. com/tools 
android : layout_width= M match_parent' 
android : layout 一 height= n match—parent' 
android : paddingLeft="16dp" 


android : paddingRight= M 16dp" 
android : paddingTop="16dp" 
android : paddingBottom= n 16 dp" 
tools : context:，' • FindBeerActivity"> 



These 

■to -the layou-t as a whole- 
They -the 

layoui v/idih a^d hcijlvt, 
wi-th a^y padd’mg 
•… "the layou 七 


<TextView 

android: text: n @string/hello_worId'▼ 
android:layout_width= n wrap_content M 
android:layout height= n wrap content" /> 


</RelativeLayout> 

The design editor 


The <7Vx • 七 m 七 he )<ML is 
rc(\ctitd *m dcsi^ cd'i*to\r- 



activity 一 find 」 )eer.xml - | 

[ipp] - Beer Adviser - 卜 /AndroidStudioProjects/BeerAdviser 】 J 

J 01 

w 

1 

'W app 

► ^ Cl > 131 ; $ li 

.1 M M 1 


/ c FindBeerActivity.java x 

<> activity_find_n 

eerjcml x 

1 Palette 卜 

f Layouts 

) ] FrameLayout 

j 困 | Nexu] 

k ▼ 0 s 

4 ， : Q)AppThemc : FindBeer^ 丨 皆 2 卜 

\ 圍纹 a 0 » 


LinearLayout (Vertical) 
TableLayout 
目 TableRow 
『 Grid Layout 
园 Relative Layout 
Pi Widgets 
|Ab| Plain TextView 
[Ab| Large Text 
|Ab| Medium Text 
|Abl Small Text 
But 


Hello world! 


you are here ► 


43 






























design editor 


Adding components with the design editor 

There are two ways of adding GUI components to the layout: via XML or 
using the design editor. Let’s start by adding a button via the design editor. 

To the left of the design editor, there’s a palette that contains GUI components 
you can drag to your layout. If you look in the Widgets area, you’ll see that 
there’s a Button component. Click on it, and drag it into the design editor. 



Create project 
Update layout 
Connect activity 
Write logic 



IWs the palette. 


tteve's Bu*tW Pv-aj i*t 

ovcv" *to layout 


© 


|g Nexus 4 ^ : j[ 




Pul ette 


tji AppTheme 


r indBeer 




Widgets 

Ab Plain TextView 
Ab Large Tejtt 
Ab Medium Text 
fei^a^l|Text 

* RadioEutton 
0 CheckBox 
■ Switch 

Toggle Button 

ImageButton 

ImageView 

"■ ProgressBar [Large 】 
™ ProgressBar [Normal) 
■ ProgressBar fSmalD 


s 囝 _ 




況 00 


itello^jidj 


^ placed ou\rs uhdev* 

the Hi。 wo\r Id/” 


yidcca 

I ^ the "Hello 
text. 


NEW BUTTON 


Changes w the design editor are reflected iw the XML 


Dragging GUI components to the layout like this is a convenient way of 

updating it. If you switch to the code editor, you，ll see that adding the todc 七 he dcsi^h edVtov adds 

button via the design editor has added some lines of code to the file: depends y/^cv-c you pladc 七 he 

… bu 七 W 1 七 、 likely 七 ha 七 youv layout 

<TextView Will look di-f-fcv-Cir>*t *to ouvs, bu 七 

android: text= n @ string/hello—world" do^*t v/ovvy, v/C yt i*t soon, 

android : layout_width="wrap_content" 
android : layout—height= n wrap_content n 

android : id= n @+id/textView" /> 丁 L , 

’he Je^zVicv/ element wc had 

〈Button bcW has bcch givch ah ID. 

android : layout_width= n wrap—content” 
android : layout_height= n wrap 一 content” 
android: text:’▼ New Button" 
android : id= n @+id/button" 
android : layout_below="@+id/textView" 
android : layout alignLeft= n @+id/textView" /> 


tV^a-t dcstv-ibcs 
■tV^c buttem you vc 
dv-a^cd *to *bV)c layout 
Well look a*t -tV^'is *m 
more detail ovcv- *tV^c 
-few pays. 
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building interactive apps 


activity_fiwd_beGr.xml has a new buttow 

The editor added a new 〈 Button 〉 element to activity_find_beer.xml\ 
<Button 

android:layout_width="wrap_content" 

android: layout 一 height= n wrap_content ，， 

android:text="New Button" 

android:id="0+id/button" 

android:layout_below="@+id/textView" 

android:layout_alignLeft= M @ + id/textView" / > 

A button in Androidville is a push-button that the user can press to trigger 
an action. It includes properties controlling its position, size, appearance, 

% and what methods it should call in the activity. These properties aren’t 
unique to buttons — other GUI components including text views have them 
too. 


buttons and text views are subclasses of the same Android View class 


There’s a very good reason why buttons and text views have 
properties in common — they both inherit from the same Android 
View class. You’ll find out more about this later in the book, but for 
now, here are some of the more common properties. 

awdroid:id 

This gives the component an identifying name. The ID property 
enables you to control what components do via activity code, and also 
allows you to control where components are placed in the layout: 

android : id="@+id/button n 

awdroid:tcxt 


This tells Android what text the component should display. In the 
case of <Button>, it’s the text that appears on the button: 

android:text="New Button" 

awdroid:layoirf—width, awdroid:layouOeight 

These properties specify the basic width and height of the 
component. n wrap_content n means it should be just big enough 
for the content: 

android : layout—width= ， 'wrap—content，' 
android : layout_height= M wrap_content" 


TKc V\t^i dldss mdludcs lots o( 
di*f*fevwt mc*thods. Well look 
a 七 -this la*tcv- *m book. 


V 
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layout code 


A closer look at the layout code 

Let’s take a closer look at the layout code, and break it down so that 
you can see what it’s actually doing (don’t worry if your code looks a 
little different, just follow along with us): 



Create project 
Update layout 
Connect activity 
Write logic 


The Relative 
Layout 


<RelativeLayout xmlns : android:"http://schemas.android.com/apk/res/android ▼’ 
xmlns : tools= M http : //schemas.android.com/tools M 
android : layout_width="match_parent M 
android : layout_height="match_parent" 
android : paddingLeft="16dp n 
android : paddingRight="16dp n 
android : paddingTop="16dp" 
android : paddingBottom="16dp" 
tools : context: n •FindBeerActivity n > 


Tills is 
■twt View 


<TextView 

android : text="@ string/hello—world” 
android : layout— width:"wrap—content" 
android : layout— height:"wrap 一 content" 
android : id="@+id/textView M /> 


□ 

BeerAdviser 

nfb 

app/sre/main 


This is -the 〈Button 

burttoh. android: lay out—width: "wrap 一 con tent” 

android : layout_height= n wrap—content” 

android:text="New Button" 

android : id="@+id/button" 

android : layout_below= n @+id/textView" 

android : layout_alignLeft= M @+id/textView M /> 


res 


□ 

layout 




activity_find_beer.xml 


</RelativeLayout> <-This doses the Relative Uyout 


The Relativelayout element 


The first element in the layout code is <RelativeLayout>. The 
<RelativeLayout> element tells Android that the different GUI 
components in the layout should be displayed relative to each other. As 
an example, you can use it to say that you want one component to 
appear to the left of another one, or that you want them to be aligned 
or lined up in some way. 


arc ways laymj 

ou*t youv- ^U| 七 oo. 

You II •f md out w\oV"C about 

latcv- or\. 


In this example, the button appears directly underneath the text view, 
so the button is displayed relative to the text view. 
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building interactive apps 


The TextYicw element 

The first element inside the <RelativeLayout> is the <TextView>: 


<TextView 

android : text="@ string/hello—world" 
android : layout_width="wrap_content" 
android : layout_height="wrap_content" 
android : id="@+id/textView" / > 


No properties have been set to specify where the text view should appear 
in the layout, so by default Android displays it in the upper-left corner of 
the screen. Notice that the text view has been given an ID of textView. 
You’ll see why this is needed when we look at the next element. 

The button element 

The final element inside the <RelativeLayout> is the <Button>: 


<Button 

android : layout_width="wrap_content n 

android : layout_height="wrap_content" 

android : text= M New Button" 

android : id="@+id/button M 

android : layout_below="@+id/textView" 

android : layout_alignLeft= M @+id/textView" / > 


When we added our button to the layout, we positioned the button so that 
it was underneath the text view, and so that the left edge of the button 
lined up with the left edge of the text view. We positioned the button 
relative to the text view, and this is reflected in the XML: 

android:layout_below= M @ + id/textView" 
android:layout_alignLeft="@+id/textView" 


There are different ways of writing the layout XML in order to produce 
the same visual effect. As an example, the XML above specifies that the 
button is positioned below the text view. An equivalent statement would be to 
say that the text view is positioned above the button. 


Using a relative 
layout means tkat 
GUI components 
will te positioned 
relative to eack 
otker. 


TV>c 七 ex •七 v*ic>w is displayed 
•m 七 he uffcv-lc-f*t do\rir>cv- by 
dc-fault 



The but-toh is set io appear below 
the view, oihd wi-th its Ic^-t 
edy vc\rt.^lly alighcd b> the U 七 
edge o-P the tex-t view. 


you are here ► 


47 






update layout 


Changes to the XML... 

You’ve seen how changes you make in the design editor are 
reflected in the layout XML. The opposite applies too — any 
changes you make to the layout XML are applied to the 
design. 

Try this now. Replace your activity_Jind_ beer, xml code with the 
following: 


BeerAdviser 



app/src/main 

L Q 


res 



activity_find_beer.xml 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= ，， match—parent，' 
android : layout—height= n match—parent，' 
android : paddingBottom= M 16dp" 
android : paddingLeft="16dp" 
android : paddingRight="16dp" 
android : paddingTop= M 16dp" 
tools : context= M .FindBeerActivity" > 


A sp*mr>cv is 
/\y>dv*o*id -fov* 
d dv-of-dov/r> 
o( values. |*t alloy/s 
you *to choose 3 
sm^le value d 
sclcdtio^. 


below 七 he sp’nrmev" 

lc-Pi-aligr> i-t b> 

the Spijr>hCV-. 


Plate a viow 

belov/ button 

a^\A Irf 七一 aliy> ’rt 
bo button 



<Spinner 

android : id= n @+id/color ▼▼ 
android : layout_width= n wrap_content" 
android : layout_height= n wrap—content” 
android : layout_alignParentTop= M true M 
android : layout 一 centerHorizontal= n true 
android : layout marginTop= M 37dp n /> 




TWis demerit displays a 

sf'mir\CV" m layout A 

sfiymev* is a dv-of-dowi^ 
|is*t o*f values. 


ton 

android : id= n @+id/find—beer' 
android : layout_width= n wrap_content" 
android : layout—height:"wrap 一 content” 
android : layout—alignLeft= n @+id/color'▼ 
android : layout__below= n @+id/color n 
android: text:’▼ Button” /> 

/^<TextV iew 

android : id= n @+id/brands '▼ 
android : layout—width= n wrap—content” 
android : layout—height:"wrap 一 content 1 
android : layout—alignLeft= n @+id/find—beer 
android : layout—below= n @+id/find—beer 1 
android : layout—marginTop= n 18dp' 
android:text= n TextView n /> 


</RelativeLayout> 





Da this! 

Replace the contents of 
activity_find_beer.xml 
with the XML shown here 
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...are reflected iw the design editor 

Once you’ve changed the layout XML, switch to the design 
editor. Instead of a layout containing a text view with a button 
underneath it, you should now see a text view displayed below a 
button. 

Above the button we have a spinner. A spinner is the Android 
term for a drop-down list of values. When you touch it, it 
expands to show you the list so that you can pick a single value. 



We’ve shown you how to add GUI components to the layout with the 
aid of the design editor, and also by adding them through XML. In 
general, you’re more likely to hack the XML to get the results you 
want without using the design editor. This is because editing the XML 
directly gives you more direct control over the layout, and means that 
you’re not dependent on the IDE. 



building interactive apps 

Create project 
Update layout 
Connect activity 
Write logic 


A spinner provides 
a drop-ctown list ol 
values* It allows you to 
ckoose a single value 
from a set ol values. 


GUI components suck 
as tuttons, spinners, 
and text views kave 


very similar attriWtes ， 
as tkey are all types 
ol View. Bekinct tlie 
scenes，tkey all inkerit 
: from tke same Anctroid 
View class. 
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add strings 


Use string resources rather 
thaw hardcoding the text 



Create project 
Update layout 
Connect activity 
Write logic 


There’s one more thing we need to change before we try 
running the app. At the moment, the button and text view 
both use hardcoded string values for their text properties. As 
we mentioned in Chapter 1, it’s a good idea to change these 
to use the strings resource file strings.xml instead. While this 
isn’t strictly necessary, it’s a good habit to get into. Using the 
strings resource file for static text makes it easier to create 
international versions of your app, and if you need to tweak 
the wording in your app, you’ll be able to do it one central 
place. 


Open up the app/sre/main/res/values/strings, xml file. When you 
switch to the XML view, it should look something like this: 


<?xml version= M 1.0" encoding= M utf-8"?> 


<resources> 


<string 


These a\rc s-tirihgs -that A^d^oid 
(Studio tYtaitd (o\r us. 

name= n app_name">Beer Adviser</string 〉 


<string name= n hello_world">Hello world!</string> 
<string name="action_settings">Settings</string 〉 


</resources 〉 


First, delete the “hello—world” resource, as we’re no longer 
using it. Then, add a new resource called “find_beer” with 
a value of u Find Beer!”. After you’ve done that, add a new 
resource named “brands” but don’t enter anything for the 
value. 


Your new code should look like this: 


〈string name= n app_name">Beer Adviser</string> 


BeerAdviser 

L Q 

app/sre/main 

L rn 


res 

L D 


val 


ues 




strings.xml 


<string name= M action_settings">Settings</string 〉 

<string name= n find_beer n >Find Beer!</string> 
<string name= n brands M X/string> ^ 



\/o\a Y\ttd *to remove 

V)cllo_y/ov-ld s*brm3 v-csouv-tc, 
ay\d add m b^o new ones 
called Wa^ds. 
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building interactive apps 


Change the layout to use the string resources 

Next, let’s change the button and text view elements in the 
layout XML to use the two string resources we’ve just added. 

Open up the activity_Jind_beer.xml file, and make the following 
changes: 



Change the line android : text= M Button n to android : text= n @string/find—beer 



Change the line android : text="TextView f, to android : text="@string/brands n . 


<Spinner 

android:id="@+id/color" 
android:layout—width= n wrap_content n 
android:layout_height= n wrap_content" 
android:layout_alignParentTop= M true" 
android:layout—centerHorizontal 二 "true" 
android:layout_marginTop= M 37dp" / > 


<Button 

android:id="@+id/find—beer" 


□ 

BeerAdviser 

43 

app/sre/main 


res 



layout 


</ 


activity_find_beer.xml 


android:layout_width="wrap_content" 
android:layout 一 height= n wrap_content n 
android:layout—alignLeft= n @ + id/color" 
android:layout_below="@+id/color" 
android:text="@string/find_beer" 

vcsouvtc OY\ 七 he button- 

<TextView 


TKis y/'ill display value 


of -f md^bccv 


android 

android 

android 

android 

android 

android 

android 


id="@+id/brands" 
layout_width= M wrap_content" 
layout_height="wrap_content" 
layout—alignLeft= n @+id/find_beer" 
layout_below= M @+id/f ind—beer，' ， 

layout marginTop= n 18dp n will display -the vajuc o-P the bvahds 

— m the Tex 七 l/iew. iVhilc iW\s 

text="@string/brands" / > ^ is bla^k, this ⑶就 《 Ay 

-to -the sVmg value will get picked up. 
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test drive 


Lcfs take the app for a test drive 

We still have more work to do on the app, but let’s see how it’s 
looking so far. Save the changes you’ve made, then choose the 
“Run c app’’’ command from the Run menu. When prompted, 
select the option to launch the emulator. 


Wait patiently for the app to load, and eventually it should 
appear. 

Try touching the spinner. It’s not immediately obvious, but 
when you touch the spinner, it presents you with a drop-down 
list of values — it’s just at this point we haven’t added any 
values to it. 

Here's what we've done so far 

Here’s a quick recap of what we’ve done so far: 



V 


Create project 
Update layout 
Connect activity 
Write logic 



Q 11:48 1 

Beer Adviser 

• 

• 

• 


This is 七 lie 

bu*t i*t has v\o — ^ 

values *i*t- 


FIND BEER! 


The bui-fco^ is 
■the spnrmev, and also Ic-Pt 
"to rt. 


o 

❺ 


Weve created a layout that specifies 
what the app will look like. 

It includes a spinner, a button, and a text view. 

The file strings.xml includes the string 
resources we need. 

We’ve added a label for the button, and an empty 
string for the brands. 



「 Dumb Questi9ns ] 

The layout looks slightly different 
when you run it compared with how it 
looks in the design editor. Why’s that? 



The activity specifies how the app 
should interact with the user. 

Android Studio has created a basic activity for us, 
but we haven’t done anything with it yet. 



The design editor does its best to show 
you how the layout will look, but it has a few 
limitations. Our layout XML speefies that the 
spinner should be centered horizontally, for 
instance, but this may not be obvious from 
the design editor. 

In practice, you’re always best off working 
directly with the XML This gives you a more 
accurate picture of what’s going on, and 
gives you a finer degree of control too. 

I thought there was a text view too? 

There is, it’s just that at the moment it 
doesn’t contain any text so you can’t see it. 
You’ll see it later on in the chapter when we 
get the text view to display some text. 
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building interactive apps 


Add values to the spinner 

At the moment, the layout includes a spinner, but it doesn’t have anything in it. 

Whenever you use a spinner, you need to get it to display a list of values so that 
the user can choose the value they want. 

We can give the spinner a list of values in pretty much the same way that we set 
the text on the button and the text view: by using a resource. So far, we’ve used 
strings.xml to specify single String values. All we need to do is specify an array of 
String values, and get the spinner to reference it. 

Adding an array resource is similar to adding a string 

As you already know, you can add a string resource to strings.xml using 

〈string name= n string_name n >string_value</string 〉 

where string_name is the identifier of the String, and string_value is the 
String value itself. 

To add an array of Strings, you use the following syntax: 

<string-array name="string 一 array 一 name”> 〜 This is o( 3v"v*ay- 

<i tem>s tring—value 1< / i tem> 

<item>string_value2</item> \ These the values i, the a^ay. /ou 
<item>string_value3</item> j 匕如 add as as you heed- 


V 


Create project 
Update layout 
Connect activity 
Write logic 


Resources are 
noncocte assets ， 
suck as images 
or strings，used 
ty your app. 


</string-array> 


where string_array_name is the name of the array, and 
string_valuel, string—value2, string—value3 are the 
individual String values that make up the array. 


Let’s add a string-array resource to our app. Open up 
strings.xml : and add the array like this: 


<string name= n brands"></string> 

<string-array name= n beer_colors n > 
<item>light</item> 
<item>amber</item> 

< i tem>br own< / i tem> 



□ 

BeerAdviser 

~ \ 

app/sre/main 

L Q 


res 


<item>dark</item> 

</string-array> 


</resources 〉 


/\dd -this sVmJ-av-^ray *to -flic 

I 七 de^'mes dy> av-ray o+ sbr^s dallcd 
bccv"__dolov*s of 

ambev, bvovm, ay>d dav-k. 



values 


卜 j 


strings.xml 
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test drive 


fret the spinner to reference a strmg-array 


A layout can reference a string-array using similar syntax to how it would retrieve 
the value of a string. Rather than use 


n @string/string name 


you use the syntax 

"@array/array 一 name 

where array—name is the name of the array. 


fx 

〉 Use b> d s*brm% ar>d 

y @av-vay *to air> av-vay- 


Let’s use this in the layout. Go to the layout file activity_Jind_beer.xml and add an 
entries attribute to the spinner like this: 

• • • 

<Spinner 

• •參 

android:layout_marginTop= M 37dp" 

android:entries= n @array/beer colors" /> 


□ 


BeerAdviser 


HU 

app/sre/main 

- — I 


res 



□ 

layout 


Test drive the spinner 


This medv>s w *thc tr\br\ts (or i\\t 
spiymCV dome -fv*om 3 V*V* 3 y beev ■— tolovs 


</ 


activity_find_beer.xml 


So let’s see what impact these changes have had on our app. Save your 
changes, then run the app. You should get something like this: 




Create project 
Update layout 
Connect activity 
Write logic 
























Wc need to make the button do something 

So far, we’ve added new GUI components to the layout, and 
populated a spinner with an array of values. What we need to do 
next is make the app react to the value we select in the spinner when 
the button is clicked. We want our app to behave something like this: 


building interactive apps 



Create project 
Update layout 
Connect activity 
Write logic 



The user chooses a type of beer 
from the spinner. 

The user clicks on the button to find 
matching beers. 



BeerExperts getBrands() method 
finds matching brands for the type 
of beer and returns them to the 
activity as an ArrayList of Strings. 



The layout specifies which method 
to call in the activity when the 
button is clicked. 



The method in the activity 
retrieves the value of the selected 
beer in the spinner and passes 
it to the getBrands() method 
in a Java custom class called 
BeerExpert. 



The activity gets a reference to 
the layout text view and sets its 
text value to the list of matching 
beers. 

This is displayed on the device. 


o 


("amber") 


BeerExpert 



Let’s start by getting the button to call a method. 


you are here ► 
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on Click attribute 


Make the button call a method 

Whenever you add a button to a layout, it’s likely you’ll want it to do 
something when the user clicks on it. To do this, you need to get the 
button to call a method in your activity. 

To get a button to call a method in the activity when it’s clicked, we 
need to make changes to two files: 



o 

o 


We need to change the layout file activity_find_beer.xml. 

We’ll specify which method in the activity will get called when the button is 
clicked. 

We need to change the activity file FindBeerActivity.java. 

We need to write the method that gets called. 


Create project 
Update layout 
Connect activity 
Write logic 


Let’s start with the layout. 

Use onClick to say which method the button calls 

It only takes one line of XML to tell Android which method a 
button should call when it’s clicked. All you need to do is add an 
android : onClick attribute to the 〈 button 〉 element, and give 
it the name of the method you want to call: 

^^^TK'is medics is dli 匕 ked) 乙 all 

android:onClick="method_name" ^ m the att.V.ty 己 ailed 

Let’s try this now. Go to the layout file activity_Jind_ beer, xml, and add 
a new line of XML to the <button> element to say that method 
onClickFindBeer () should be called when the button is clicked: 


<Button 


□ 

BeerAdviser 


android : id= M @+id/find—beer" 
android : layout—width= n wrap_content n 
android : layout_height= M wrap_content" 
android : layout_alignLeft="@+id/color" 
android : layout_below= M @+id/color" 
android : text= M @string/find—beer，' 
android:onClick="onClickFindBeer" /> 


app/sre/main 

L n 


res 

LQ 

layout 



... 

Once you’ve made these changes, save the file. 

Now that the layout knows which method to call in the activity, 
we need to go and write the method. Let’s take a look at the 
activity. 


iVhe 灼七 he butfco 灼 is didked, 

乙 all method o^ClifikFihdBccv"0 

’m 七 he a^iiviiy. IVcII dvcaic 
"the rwc*thod \y\ -the adtivi-ty 
ovc\r 七 he nwt -Pew pages. 


activity_find_beer.xml 
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building interactive apps 


What activity code looks like 


When we first created a project for our app, we asked the wizard to create a 
basic activity for us called FindBeerActivity. The code for this activity is 
held in a file called FindBeer A ctivity.java. Open this file by going to the app/src/ 
main/java folder and double-clicking on it. 

When you open the file, you’ll see that Android Studio has generated a lot of 
Java code for you. Rather than taking you through all the code that Android 
Studio has created for you, we want you to replace it with the code below. 

This is because a lot of the activity code that Android Studio has generated is 
unnecessary, and we want you to focus on the fundamentals of Android itself 
rather than the quirks of a single IDE. So delete the code that’s currently in 
FindBeerActivity.jam ， and replace it with the code shown here: 



BeerAdviser 


app/src/main 

L [I3 

java 

L n 

com.hfad.beeradviser 



FlndBeerActivity.java 


package com.hfad.beeradviser; 


import android.os.Bundle; 
import android.app.Activity; 


TKc dldss f[y\Aro\A 

M 七〜士 /山 ss . 


public class FindBeerActivity extends Activity { ... ,,, 

TW,S *,S Its called 

ad-tWity first seated- 

protected void onCreate(Bundle savedlnstanceState) { 



super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity find beer); 


sciCo>r>ic^i\/icv/ -tells A^dv-oid 
whidh layoui 七 he uses. | 灼 

"this dase, rt’s a^tivrty -ri^d beev*. 


The above code is all you need to create a basic activity. As you can see, it’s a 
class that extends the android. app . Activity class, and implements an 
onCreate () method. 

All activities have to extend the Activity class. The Activity class contains 
a bunch of methods that turn your Java class from a plain old Java class into a 
full-fledged, card-carrying Android activity. 

All activities also need to implement the onCreate () method. The 
onCreate () method gets called when the activity object gets created, and it’s 
used to perform basic setup such as what layout the activity is associated with. 
This is done using the setContentView () method. In the example above, 
setContentView (R. layout. activity—find 一 beer ) tells Android 
that this activity uses activity—find_beer as its layout. 



Replace the code 
in your version of 
FindBeerActivityJava 
with the code shown 


On the previous page, we added an onClick attribute to the button in our 
layout and gave it a value of onClickFindBeer. We need to add this method 
to our activity so it will be called when the button gets clicked. This will enable 
the activity to respond when the user touches a button in the user interface. 


on this page. 
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on ClickFindBeerQ 


Add an onClickFindPeerO method 
to the activity 



Create project 
Update layout 
Connect activity 
Write logic 


The onClickFindBeer () method needs to have a particular 
signature, otherwise it won’t get called when the button specified in the 
layout gets clicked. The method needs to take the following form: 

public void onClickFindBeer(View view) { 
} \ 




The rwrthod mus*t be 

public. 


The method mus 七 have a 
void value- 


The method mus*t have a smjlc 
pav-amc*tc\r -type View. 


If the method doesn’t take this form, the method won’t respond 
when the user touches the button. This is because behind the 
scenes, Android looks for a public method with a void return value, 
with a method name that matches the method specified in the 
layout XML. 

The View parameter in the method may seem unusual at first 
glance, but there’s a good reason for it being there. The parameter 
refers to the GUI component that triggers the method (in this case, 
the button). As we mentioned earlier, GUI components such as 
buttons and text views are all types of View. 

So let’s update our activity code. Add the onClickFindBeer () 
method below to your activity code: 


II you want a metkoct 
to respond to a button 
click，it must te puLlk ， 
Itave a void return 
type，and take a single 
View parameter. 


us'ma this 

參 • • 

dass, so wc heed import android. view. View; 

io — 。七 t 


BeerAdviser 


public class FindBeerActivity extends Activity 


^//Call when the user clicks the button 


Add *t^c 

OY\ 

method *to 

F"'mdBccV"A^*t , v*i*tY j3 v 3- public void onClickFindBeer (View view) { 


L Q 

app/sre/main 


</Layou-t> I 


onClickFindBeer()^ 



java 

LQ 

com.hfad.beeradviser 

■ <la»> Fm{| 

FlndBeerActivity.java 


activity—find—beer.xml 


FindBeerActivity.java 
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onClickFmdPeerO needs to ^ something 

Now that we’ve created the onClickFindBeer () method in our 
activity, the next thing we need to do is get the method to do something 
when it runs. We need to get our app to display a selection of different 
beers that match the beer type the user has selected. 

In order to achieve this, we first need to get a reference to both the spinner 
and text view GUI components in the layout. This will allow us to retrieve 
the value of the chosen beer type from the spinner, and display text in the 
text view. 


building interactive apps 



Create project 
Update layout 
Connect activity 
Write logic 


Use fiwdYiewPyMO to get a reference to a view 


We can get a handle for our two GUI components using a method called 
f indViewByld () . The f indViewByld () method takes the ID of 
the GUI component as a parameter, and returns a View object. You then 
cast the return value to the correct type of GUI component (for example, 


a TextView or a Button). 

Here’s how you’d use f indViewByld () to get a reference to the text 
view with an ID of brands: 


1/Vlc 娜七 viow Vi 七 h 

diY\ IP o*f bv-aiads. 




TextView brands = (TextView) findViewByld(R.id.brands); 

个 


brands is a so v/c 


have *bo tas*t *i*t as 


Take a closer look at how we specified the ID of the text view. Rather than 
pass in the name of the text view, we passed in an ID of the form 
R. id. brands. So what does this mean? What’s R? 

R.java is a special Java file that gets generated by the Android tools 
whenever you create or build your app. It lives within the app/build/ 
generated/source/r/debug folder in your project in a package with the same 
name as the package of your app. Android uses R to keep track of the 
resources used within the app, and among other things it enables you to 
get references to GUI components from within your activity code. 

If you open up R.java, you’ll see that it contains a series of inner classes, 
one for each type of resource. Each resource of that type is referenced 
within the inner class. As an example, R includes an inner class called id, 
and the inner class includes a static final brands value. The line 
of code 

(TextView) findViewByld(R•id•brands); 
uses this value to get a reference to the brands text view. 


R is a special Java class 
tkat enables you to 
retrieve references to 
resources in your app. 


o 



R, but it’s useful to know it’s 
there. 
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view methods 


Once you have a View, you can access its 
methods 

The f indViewByld () method provides you with a Java version of your 
GUI component. This means that you can get and set properties in the 
GUI component using the methods exposed by the Java class. Let’s take a 
closer look. 



Create project 
Update layout 
Connect activity 
Write logic 


Setting the text iw a TextYiew 

As you’ve seen, you can get a reference to a text view in Java using 

TextView brands = (TextView) findViewByld(R•id•brands); 


When this line of code gets called, it creates a TextView object called 
brands. You are then able to call methods on this TextView object. 


Let’s say you wanted to set the text displayed in the brands text view 
to “Gottle of geer”. The TextView class includes a method called 
setText () that you can use to change the text property. You use it like 
this: 


brands.setText("Gottle of geer"); 


Sci 七 he ov\ 七 he b\ra^ds 

-to KK 6{o{,Wt o-P gee〆’ 


Retrieving the selected value w a spmner 

You can get a reference to a spinner in a similar way to how you get a 
reference to a text view. You use the f indViewByld () method as before, 
only this time you cast the result as a Spinner: 

Spinner color = (Spinner) findViewByld(R•id.color); 


This gives you a Spinner object whose methods you can now access. 

As an example, here’s how you retrieve the currently selected item in the 
spinner, and convert it to a String: 

String. valueOf (color. getSelectedltem()) ^ 、 This gets ihc selected rtdm a 


The code 

color.getSelectedltem() 


spnrmev do^vc\rts i-t "to 3 


actually returns a generic Java object. This is because spinner values can 
be something other than Strings, such as images. In our case, we know 
the values are Strings, so we can use String . valueOf () to convert 
the selected item from an Ob j ect to a String. 
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building interactive apps 


Update the activity code 

You now know enough to write some code in the onClickFindBeer () 
method. Rather than write all the code we need in one go, let’s start by 
reading the selected value from the spinner, and displaying it in the text view. 



Activity Magnets 

Somebody wrote a new onClickFindBeer () method using fridge magnets 
for us to slot into our activity. Unfortunately, a freak kitchen whirlwind has 
dislodged the magnets. Can you piece the code back together again? 

The code needs to retrieve the type of beer selected in the spinner, and then 
display the type of beer in the text view. 


//Call when the button gets clicked 

public void onClickFindBeer( view) { 


//Get a reference to the TextView 

brands — 



//Get a reference to the Spinner 

Spinner = ( 


//Get the selected item in the Spinner 
String = String.valueOf(color. 


/ /Display the selected item 
brands. (beerType); 


^TexWiewj 


Button 1 




You woh ’ 七 
y\ttA use 
3ll o( -the 


beerType 


^findV^^yldk 
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magnets solution 



Activity Magnets Solution 

Somebody wrote a new onClickFindBeer () method using 
fridge magnets for us to slot into our activity. Unfortunately, a freak 
kitchen whirlwind has dislodged the magnets. Can you piece the 
code back together again? 


The code needs to retrieve the type of beer selected in the spinner, 
and then display the type of beer in the text view. 


//Call when the button gets clicked 
public void onClickFindBeer( 



view) 


//Get a reference to the TextView 

TextView I brands = | (TextView) | findViewByld [( 


//Get a reference to the Spinner 
Spinner 



color 


I (Spinner) 


findViewByld I( 



//Get the selected item in the Spinner 
String beerType I = String.valueOf(color. 

/ /Display the selected item 
brands. 



setText 


(beerType); 






I didn't -to use 

*tV)CSC 
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The first version of the activity 

Our cunning plan is to build the activity in stages, and test it as we go 
along. In the end, the activity will take the selected value from the spinner, 
call a method in a custom Java class, and then display matching types of 
beer. For this first version, our goal is just to make sure that we correctly 
retrieve the selected item from the spinner. 

Here is our activity code, including the method you pieced together on 
the previous page. Apply these changes to FindBeerActivity.java ， then save 
them: 


building interactive apps 



Create project 
Update layout 
Connect activity 
Write logic 


package com.hfad.beeradviser; 


import 

import 

import 

import 

import 


android. os• Bundle; 


android.app.Activity; 


android.view.View; 
android.widget.Spinner; 
android.widget.TextView; 



WicVc usmj *t^csc 
classes. 


public class FindBeerActivity extends Activity { 


□ 

BeerAdviser 

_P 2 

_I 

app/sre/main 

L Q 



com. hfad. beeradviser 



Find Beer Activity.java 


@Override 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 


l/Vlc vc "this methodi¬ 


se tContentView (R.layout.activity—find—beer); 


//Call when the button gets clicked 
public void onClickFindBeer(View view) { 

//Get a reference to the TextView 

TextView brands = (TextView) f indViewByld (R. id.brands) ; -fmdViO/Byld v-c*tu\nr\S d 
//Get a reference to the Spinner , *to 6 今 st 


Spinner color = (Spinner) findViewByld(R.id.color); 

//Get the selected item in the Spinner 

String beerType = String.valueOf(color.getSelectedltem()); 
//Display the selected item A 

\ jctScIcdicdlicm 
v-c*tuv-^s ^Y\ 0\)\tt 
Yo[a y\tt& "to 

irrto a 


•bo i\^t type View. 


brands.setText(beerType); 


i 七 
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what happens 


What the code does 

Before we take the app for a test drive, let’s look at what the code 
actually does. 


V 

V 


Create project 
Update layout 
Connect activity 
Write logic 



The user chooses a type of beer from the spinner and clicks on the Find Beer button. 
This calls the public void onClickFindBeer(View) method in the activity. 

The layout specifies which method in the activity should be called when the button is clicked via the 
android : onClick property of the button. 



FindBeerActivity 



The activity gets references to the TextView and Spinner GUI components using calls 
to the findViewByldQ method. 



FindBeerActivity 


TextView 



Spinner 




The activity retrieves the currently selected value of the spinner, and converts it to a 
String. 



FindBeerActivity Spinner 



The activity then sets the text property of the TextView to reflect the currently 
selected item in the spinner. 


"amber" 




FindBeerActivity 


TextView 
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building interactive apps 



Test drive the changes 

Make the changes to the activity file, save it, and then run 
your app. This time when we click on the Find Beer button, it 
displays the value of the selected item in the spinner. 

TV>c -type o-f beev- selected is 
displayed'm -the viev/. 




Dumb Quest? 


9ns 


I added a string to my strings.xml file but I can’t see it in 
R.java. Why isn’t it there? 

Android Studio, generates R.java when you save any 
changes you’ve made. If you’ve added a resource but can’t see it in 
R.java, check that your changes have been saved. 

R.java also gets updated when the app gets built. The app builds 
when you run the app, so running the app will also update R.java. 

The values in the spinner look like they’re static as 
they’re set to the values in the string-array. Can I 
change these values programmatically? 

You can, but it’s more complicated than just using static 
values. We’ll show you later in the book how you can have 
complete control over the values displayed in components such as 
spinners. 

What type of object is returned by 
getSelectedltem()? 

It's declared as type Ob j ect. Because we used a 
string-array for the values, the actual value returned in 
this case is a String. 


In this case? Isn’t it always? 

You can do more complicated things with spinners than just 
display text. As an example, the spinner might display an icon 
next to each value. As getSelectedltem () returns an 
Ob j ect, it gives you a bit more flexibility. 

Does the name of onClickFindBeer matter? 

All that matters is that the name of the method in the activity 
code matches the name used in the button’s onClick attribute 
in the layout. 

Why did we replace the activity code that Android Studio 
created for us? 

IDEs such as Android Studio include lots of time-saving 
functions and utilities that can save you a lot of time. They generate 
a lot of code for you, and sometimes this can be useful. When 
you’re learning a new language or development area such as 
Android, we think it’s best to learn about the fundamentals of the 
language rather than what the IDE generates for you. This way 
you’ll develop a greater understanding of it, which you’ll then be 
able to use no matter which IDE you use. 


you are here ► 


65 










BeerExpert 


Puildmg the custom Java class 

As we said at the beginning of the chapter, the Beer Adviser app 
decides which beers to recommend with the help of a custom 
Java class. The custom Java class is written in plain old Java, with 
no knowledge of the fact it’s being used by an Android app. 

Custom Java class spec 

The custom Java class should meet the following requirements: 

o 
o 
o 



Layout 


The package name should be com. hf ad. beer adviser. 

The class should be called BeerExpert. 

It should expose one method, getBrands (), that takes a 
preferred beer color (as a String), and return a List<String> of 
recommended beers. 




strings.xml 



BeerExpert 


1/Vc v>ccd b> dvcaic 
a Java dlass 

use •fco -f 'md ou 七 
^\\'\t\\ beev bvay>ds 
*to surest 


M\d and test the Java class 

Java classes can be extremely complicated and involve calls to complex 
application logic. You can either build and test your own version of the 
class, or use our sophisticated version of the class shown here: 


□ 


BeerAdviser 


package com.hfad.beeradviser; 
import java.util.ArrayList; 
import j ava.util.List; 


L d 

app/sre/main 


java 


TVus is fuve Java Codt) 
wtWi% A^dvoidy about it 



public class BeerExpert { 

List<String> getBrands(String color) { 

List<String> brands = new ArrayList<String>() 
if (color.equals("amber")) { 

brands.add("Jack Amber"); 
brands.add("Red Moose"); 

} else { 

brands.add("Jail Pale Ale"); 
brands.add("Gout Stout"); 



com. hfad. beeradviser 

I \t\»u 

a 

BeerExpert.java 


fills! 


return brands 


Add the BeerExpert class to your project. 
Highlight the com.hfad.beeradviser 
package in the applsrclmainljava 
folder, and go to File-^New...^Java 
Class. A new class will be created in the 
package. 
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Enhance the activity to call the custom 
Java class so that we can get REAL advice 

In version two of the activity we need to enhance the onClickFindBeer () 
method to call the Beer Expert class for beer recommendations. The code 
changes needed are plain old Java. You can try to write the code and run the 
app on your own, or you can turn the page and follow along. 


building interactive apps 


V 

V 


Create project 
Update layout 
Connect activity 
Write logic 


q^arpen your pencil 


Enhance the activity so that it calls the BeerExpert 
getBrands () method and displays the results in the text view. 


package com.hfad.beeradviser; 


import 

import 

import 

import 

import 

import 

import 


android.os.Bundle; 
android.app.Activity; 
android.view.Menu; 
android.view.View; 
android.widget.Spinner; 
android.widget.TextView; 

java.util.List; ^ ^ added iK'.s Imc U you- 


public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert();^ 、 

參 • 

//Call when the button gets clicked 
public void onClickFindBeer (View view) { Bddcd 七 his l*mc -fov* you "too. 

//Get a reference to the TextView 


Y\ttd -to use -the 

tlass -to get 七 he 
beev \rcdorwinf\c^da"tior>s, so v/c 


TextView brands = (TextView) findViewByld(R•id•brands); 
//Get a reference to the Spinner 


Spinner color = (Spinner) findViewByld(R•id•color); 

//Get the selected item in the Spinner 

String beerType = String•valueOf(color•getSelectedltem()); 


个 

You heed -to update the ohClidkPmdBccvO method- 
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sharpen solution 


O^terpen your pencil 


Enhance the activity so that it calls the BeerExpert 
getBrands () method and displays the results in the text view. 


package com.hfad.beeradviser; 


import 

import 

import 

import 

import 

import 

import 


android.os.Bundle; 
android.app.Activity; 
android.view.Menu; 
android.view.View; 
android.widget.Spinner; 
android.widget.TextView; 
java.util.List; 


public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert(); 


//Call when the button gets clicked 
public void onClickFindBeer(View view) { 
//Get a reference to the TextView 


TextView brands = (TextView) findViewByld(R•id•brands); 
//Get a reference to the Spinner 

Spinner color = (Spinner) findViewByld(R•id•color); 
//Get the selected item in the Spinner 


String beerType = String•valueOf(color•getSelectedltem()); 

// 今 e 七 \redor^mehda*tior\s -from -the dass 

Lis*t<S*brmg> bra^dsList ― c%pc\rt*ytBv-ahds(beev-Typc); 七七 a Lis 七 Wa 灼 ds ， 

S-tym^Buildcv- bvandsPormattedl 二 ney/ Idcr ()； ^* Build d S-tv-mg 

"the values -the Lis 七 . 

-for (S'tv'mj brdhd : brar\dsList) { 

brar\dsFormaticd appchd^brahd).appchd^\h); P'isflay kv-a^d 

oy\ a I'mc- 

} 

/ /Display {he beers 




Usm(X BecvEwt pure Java Co(Xt t S 

4 Yow 6。如 looks a little d ••沁心 


Java todc, so do^*t 

OIaV"S. 


68 Chapter 2 







Activity code version l 

Here’s our full version of the activity code. Apply the changes to 
your version of FindBeerActivity.java ， make sure you’ve added the 
Beer Expert class to your project, and save your changes: 


building interactive apps 



Create project 
Update layout 
Connect activity 
Write logic 


package com.hfad.beeradviser; 

import android.os.Bundle; 
import android.app.Activity; 
import android.view.Menu; 
import android.view.View; 
import android.widget.Spinner; 
import android.widget.TextView; 

import java.util.List;^. i^Vc usmg this dass. 


H 3 


BeerAd 


viser 


L n 

app/sre/main 

L Q 


java 


Hi 


com. hfad. beeradviser 

Find Beer Activity.java 


public class FindBeerActivity extends Activity { 

private BeerExpert expert = new BeerExpert(); 

八 ^ Add as a ^ait variable. 


QOverride 


protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity 一 find—beer); 


//Call when the button gets clicked 
public void onClickFindBeer(View view) { 
//Get a reference to the TextView 


TextView brands = (TextView) findViewByld(R•id.brands); 
//Get a reference to the Spinner 

Spinner color = (Spinner) findViewByld(R•id•color); 
//Get the selected item in the Spinner 


String beerType = String•valueOf(color•getSelectedltem()); 

//Get recommendations from the BeerExpert class 

List<String> brandsList = expert. getBrands (beerType) ; , St dbss 

StringBuilder brands Formatted = new StringBuilder () - ^ ^ _ S 


for (String brand : brandsList) { 

brandsFormatted.append(brand).append('\n') 


.Build a SVm 少 disflaym^ 
’ eadh bvand d I'mc 


//Display the beers 

brands. setText (brandsFormatted) ； Display -the SVmg m -the 
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what happens 


What happens when you ruw the code 



When the user clicks on the Find Beer button, the 
onClickFindBeer() method in the activity gets called. 

The method creates a reference to the spinner and text view, and gets the 
currently selected value from the spinner. 



Layout Find Beer Activity 



TextView 


❺ The onClickFindBeer() calls the getBrands() method in the 

BeerExpert class, passing in the type of beer selected in the 
spinner. 

The getBrands () method returns a list of brands. 


getBrands ("amber") 



RndBeerActivity "Red Moose" BeerExpert 



The onClickFindBeer() method formats the list of brands and 
uses it to set the text property in the text view. 


"Jack Amber 



FindBeerActivity TextView 
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Test drive your app 

Once you’ve made the changes to your app, go ahead 
and run it. Try selecting different types of beer and 
clicking on the Find Beer button. 


V 

\/ 

\7 


building interactive apps 

Create project 
Update layout 
Connect activity 
Write logic 



When you choose different types of beer and 
click on the Find Beer button, the app uses the 
BeerExpert class to provide you with a selection 
of suitable beers. 
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toolbox 



Your Android Toolbox 

You’ve got Chapter 2 under 
your belt and now you’ve 
added building interactive 
Android apps to your toolbox. 


You do>wy\load 
-full Code -for 

i\\t Aa? 七 er -fv-om 

HcadPtv-stAv'dvoid. 



BULLET POINTS 


The Button element is used to add a button. 


■ The Spinner element is used to add a spinner. A spinner is a drop-down list 
of values. 

■ All GUI components are types of view. They inherit from the Android view 
class. 


■ 


■ 


■ 


■ 


■ 


■ 


Add an array of string values using: 

<string-array name="array"> 
<item>stringl</item> 


</string-array> 

■ Reference a string-array in the layout using: 

"@array/array—name ’ 1 

■ Make a button call a method when clicked by adding the following to the layout: 

android : onClick="clickMethod n 


There needs to be a corresponding method in the activity: 

public void clickMethod(View view){ 

} 

R.java is generated for you. It enables you to get references for layouts, GUI 
components, Strings, and other resources in your Java code. 

Use f indviewByid () to get a reference to a view. 

Use setText() to set the text in a view. 

Use getSelectedi tem () to get the selected item in a spinner. 

Add a custom class to an Android project by going to File 
menu^New...^Java Class. 
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3 multiple acdVities and Intents 



I sent an intent asking who 
could handle my ACTION—CALL 
and was offered all sorts of 
activities to choose from. 


State Your Intent 


w 


Most apps need more than one activity. 

So far we’ve just looked at single-activity apps, which is fine for simple apps. But when 
things get more complicated, just having the one activity won’t cut it. We’re going to show 
you how to build apps with multiple activities, and how you can get your apps talking 
to each other using intents. We’ll also look at how you can use intents to go beyond the 
boundaries of your app and make activities in other apps on your device perform 
actions. Things just got a whole lot more powerful... 


this is a new chapter 



tasks 


Apps can contain more thaw one activity 

Earlier in the book, we said that an activity is a single, defined thing 
that your user can do, such as displaying a list of recipes. If your 
app is simple, this may be all that’s needed. 

A lot of the time, you’ll want users to do more than just one thing — 
for example, adding recipes as well as displaying a list of them. 

If this is the case, you’ll need to use multiple activities: one for 
displaying the list of recipes and another for adding a single recipe. 

The best way of seeing how this works is to see it in action. You’re 
going to build an app containing two activities. The first activity will 
allow you to type a message. When you click on a button in the first 
activity, it will launch the second activity and pass it the message. 

The second activity will then display the message. 


An activity is a single 
iocused tiring your user 
can do* H you ckain 
multiple activities togetker 
to do sometking more 
complex, it’s called a task. 


The -fi\rsi adiiviiy 
you a message- 



Here are the steps 

o Create a basic app with a single activity and layout. 

❺ Add a second activity and layout, 
o Get the first activity to call the second activity, 

o Get the first activity to pass data to the second activity 
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multiple activities and intents 


Here's the app structure 


The app contains two activities and two layouts. 



When the app gets launched, it starts activity 
CreateMessage Act ivity. 

This activity uses the layout activity_create_message, xml. 



The user clicks on a button in CreateMessage Act ivity. 

This launches activity ReceiveMessageActivity, which uses layout 
activity_ receive_ message, xml. 




Device 


activity_create_message.xml activity—receive—message.xml 

via 

is *tvar>s-fcv-vcd *to 

O \ - Rcdci vcM essay 



CreateMessageActivity.java 


ReceiveMessageActivity.java 


Create the project 

You create a project for the app in exactly the same way you 
did in previous chapters. Create a new Android Studio project 
for an application named “Messenger” with a package name 
of com. hf ad. messenger. The minimum SDK should be 
API 15 so that it will work on most devices. You’ll need a blank 
activity called “CreateMessageActivity” with a layout called 
“activity—create_message” so that your code matches ours. 


Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


On the next page, we’ll update the activity’s layout. 
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update layout 


Update the layout 

Here’s the XML for the activity—create—message.xml file. We removed the 
< Text View 〉 that Android Studio created for us, and replaced it with 
<Button> and <EditText> elements. The <EditText> element gives 
you an editable text field you can use to enter data. 

Change your activity—create—message.xml file to match the XML here: 


□ 

Messenger 



app/sre/main 

Lrn 

> r I n-.J 



activity_create 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android" message.xml 

xmlns : tools= n http://schemas.android.com/tools" 
android:layout 一 width= n match—parent n 
android: layout—height= n match—parent，' 
android:paddingBottom="16dp" 
android:paddingLeft="16dp" 
android:paddingRight= M 16dp" 
android:paddingTop= M 16 dp" 
tools : context=".CreateMessageActivity" > 


Replace ihc 

£*tudio ^Wcs 
you >wi 七七 he 


<Button 

android : id="@+id/send M 
android : layout—width= n wrap—content” 
android : 1ayout 一 height= n wrap—content” 
android : layout—alignParentLeft= n true n 
android : layout_alignParentTop="true" 
android : layout_marginLeft= n 3 6dp" 
android : layout_marginTop= ’▼ 2 ldp n 

android:onClick= n onSendMessage n ♦ Clidk'mg oy\ butto 灼 v*ur>s 

android:text= n @string/send" /> 

This is a 

<EditText 

trcsouvtc. 

android : id= M @+id/message M 
android : layout—width: n wrap—content” 
android : layout 一 height= n wrap—content” 
android : layout_alignLeft= n @+id/send n 
android : layout_below= n @+id/send M 
android : layout_marginTop="18dp" 
android : ems="10" /> 

</RelativeLayout> This dcstv'ibcs Koy/ wide *tKc 

should be- |*t should be v/idc cr>ou^ *to 
addommodaic 10 letter 



o^Sc^dAlcssa^cO method m 七 k ad*tiv'i*ty- 

Tke <EJitText> element 
ctelines an ectitaLle text 
iield for entering text. It 
inkerits from tke same 
Android View class as tke 
otker GUI components 
weVe seen so far. 
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Update striwgs.xml 


The button we added has a text value of @string/send. This 
means we need to add a string called “send” to strings.xml and 
give it a value. This value is the text we want to appear on the 
button. Do this now: 

參 • • 

<string name= n send M >Send Message</string> 


multiple activities and intents 

Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


Messen 


□ 

nger 

L Q 

app/src/main 

L a 


•••and add the method to the activity 

The line in the <Button> element 

android : onClick="onSendMessage n 

means that the onSendMessage () method in the activity 
will fire when the button is clicked. Let’s add this method to the 
activity now. 

Open up the CreateMessageActivity.java file and replace the code 
Android Studio created for you with the following: 


Add 

called scr\d. Wic ^avc 
ouvs a value o^c 
Message so 
七七 w £c^d Message 

appeav-s ov\ butto 


res 

mz 3 


values 

■ \<>cml>j 

[</ %vr\\\ 

strings.xml 


package com.hfad.messenger; 

import android.app.Activity 
import android.os.Bundle; 
import android.view.View; 


WleVc todt 七 

/Wdvoid Studio dvcaicd (or us, 
3s mos*t o-f CoAt i*t £.v*ca*tcs 
•is〆 七 vc^uivcd. 


M 


public class CreateMessageActivity extends Activity { 

The or\Cvca*tcO method ybs tailed 


□ 

essenge 



@Override 




-tiic is seated. 


app/src/main 


protected void onCreate(Bundle savedinstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity create message); 


//Call onSendMessage() when the button is clicked 
public void onSendMessage (View view) { j || 

} buttoh’s disked. 

} body as wc wov-k 

o( the 

Now that you’ve created the first activity, let’s move on to the 
second. 


java 

LQ 

com.hfad.messenger 

cUs * F *^ p | 

o 

CreateMessage 

Activity.java 


jet td\\td whch the 
l/V’ll Complete the method 
ou\r way -thvough the wt 
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create activity 


Create the second activity and layout 

Android Studio has a wizard that lets you add extra activities and layouts to 
your apps. It’s like a cut-down version of the wizard you use to create an app, 
and you use it whenever you want to create a new activity. 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


To create the new activity, choose File New Activity, and choose the 
option for Blank Activity. You will be presented with a new screen where you 
can choose options for your new activity. 


Every time you create a new activity and layout, you need to name them. 
Give the new activity a name of “ReceiveMessageActivity” and the layout a 
name of “activity_receive_message”. Check that the package name is “com. 
hfad.messenger”. Accept the rest of the defaults, and when you’re done, click 
on the Finish button. 


0 O O 


Choose options for your new file 

Call ^ adtiviiy a^d Ihc layou-t VtWi 切一 咐― 一 

Creates a new blank activity with an action bar. 



Blank Activity 



Activity Name: 

Layout Name: 

Title: 

Menu Resource Name: 


Hierarchkal Parent: 
Package name: 



The name of the activitv class to create 


Cancel 


Previous 


Next 


Finish 


七 the 
vcs*t ok 七 he 
dc-faults, as all 
y/cVc *m*tcv-cs*tcd 
•m is dveatm^ 

a y \ c^j activity 
a^d layout- l/Vc II 
vcpladc most 
of todt 
/Wvoul Studio 
^ivcs us. 
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multiple activities and intents 


Project 


G + I B' 


Mess«nger /AndroidStud[oProjects/M^ssenger) 

► Q .idea 



D build 
tl libs 
D src 

► C] anidroidTest 
▼ D main 
D java 

com.hfad.messenger 
1 二 1 ia Create Message Activity 
c 丨 Rece ive Me 5 sa geAaivity 



dra wattle 
layout 

.a ctivitv_create_m essage .xmt 
。 activitv_recefve_m.xmt 

► E menu 

► [ ] mlpmap-hdpi 

► [: j mlpmap-mdpi 
► 【 mlpmap-xhtJpi 

► [ mlprnap-xxhdpE 

► [ values 

► [ valufls-wSZOtlp 
■ ArtdroitlMa nife st.xml 

0 .gitignore 
app.lml 
build.gradl-e 
@ proguard-rule 5. pro 
D grad le 
0 .gitignore 
^ bulld.gradle 


© O O 


D 0 ^ AOS 


activity 一 re« 


Messenger f ^PP 



What just happened? 

When you clicked on the Finish button, Android Studio 
created a shiny new activity file for you, along with a new 
layout. If you look in the explorer, you should see that a new 
file called ReceiveMessageActivity.jam has appeared in the app/ 
sre/main/java folder, and a file called activity_receive_ message, 
xml has appeared under app/src/main/res/layout. 


Wtrts -the y>ev/ adtivi-ty ar\d layout >wc jus 七 dv-ca*tcd. 

adtivifecs air>d lavou*b m 七 he aff- 


Ti^cv-c av-c v>o>w *t>wo 


Each activity uses a different layout. 
CreateMessageActivity uses the layout activity— 
create_message.xm /, and ReceiveMessageActivity 
uses the layout activity_receive_message, xml. 





activity—create—message.xml activity_receive_message.xml 




CreateMessageActivity.java RecieveMessageActivity.java 


Behind the scenes, Android Studio also made a configuration 
change to the app in a file called AndroidManifest.xml. Let’s 
take a closer look. 


app 


U3 『 0JQ_:T 0 3Jn3unhs :Z 


si!!JGSLL. : nJI 
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AndroidManifest.xml 


Welcome to the Android manifest file 

Every Android app must include a file called AndroidManifest.xml.You can 
find it in the app/sre/main folder of your project. The AndroidManifest.xml 
file contains essential information about your app, such as what activities it 
contains, required libraries, and other declarations. Android creates the file for 
you when you create the app. If you think back to the settings you chose when 
you created the project, some of the file contents should look familiar. 

Here’s what our copy of AndroidManifest.xml looks like: 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


□ 

Messenger 



A^dv-oid/VIa^i-Pcst.^rwl 
’m 七 his -Poldev-. 


app/sre/main 



AndroidManifest.xml 


<?xml version="1.0" encoding= M utf-8"?> 

〈manifest xmlns : android="http :// schemas.android.com/apk/res/android 
package= M com.hfad.messenger" > ^ — This is 


spcdi-f icd- 


〈application 

android:allowBackup="true M 
android:icon="@mipmap/ic—launcher’ 
android:label= M @string/app_name" 
android:theme= M @style/AppTheme n > 


A^dv-o'id S*tud"io ^avc ouv- 

-aff a dc-faul*t \toY\. 1/Ve’ll 

look ai -this la 七伙 m 七 he 
book- 

The "theme 七 he 

o( -the app. 

I/Vcll look a*t "this la-tcv-. 



This is 
七 he -Piv-s-t 
a^iiviiy, 
C\rcaic 
Message 


If you 
develop 
Android 
apps 
without 
an IDE, you’ll 
need to create 
this file manually. 


Watch it! 



This bit spcdi-Pics 
that it s the 
activity of -the app. 


〈activity 

android:name= M .CreateMessageActivity" 
android:label="@string/app_name" > 

<intent-filter> 

<action android:name="android.intent.action.MAIN 
〈category android : name="android.intent.category.LAUNCHER" / > 

</intent-filter> 々 

• 〈 /activity 〉 TV^is says attivity 

TK'is is 

sttoY\A ^activity 

android : name=".ReceiveMessageActivity 

android:label= n @string/title_activity_receive_message n > 

(</activity> 

A^dv*oid Studio added -these I •mes -Pov- 
</application> u s v/c added ihc activity. 

〈 /manifest 〉 


be used *to • 
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Every activity needs to be declared 

All activities need to be declared in AndroidManifest.xml. If an activity 
isn’t declared in the file, the system won’t know it exists. And if the 
system doesn’t know it exists, the activity will never run. 

You declare an activity in the manifest by including an 〈 activity 〉 
element inside the 〈 application 〉 element. In fact, every activity 
in your app needs a corresponding <activity> element. Here’s the 
general format: 


If I’m not included in 
AndroidManifest.xml, then 
as far as the system's 
concerned, I doiVt exist 
and will never run. 


〈application y 

n — ad*twi*ty r\ccdis xo be 

• • • > inside clem ⑼七 . 

〈activity This Imc is r^a^d^'tovy. 

android:name="activity class name" 丁卜 i. 朽丄 . 

一 This Imc is optional, 

android: label= n @string/activity 一 label” but A^dv-oid Studio 

... 〆 domplcics *i*t (or us. 

...The adtiviiy 你 ay have oihev- pvopcv-tics -too. 


O 


0 



Activity 


</activity> 


</application 〉 


The following line is mandatory and is used to specify the class name of 
the activity:: 

android : name= n activity class name" 


activity_class_name is the name of the class, prefixed with a 
“.’’•In this case, it’s . ReceiveMessageActivity. The class name 
is prefixed with a because Android combines the class name with 
the name of the package to derive the fully qualified class name. 


This line is optional and is used to specify a user-friendly label for the 
activity: 

android : label="@string/activity_label n 

It’s displayed at the top of the screen when the activity runs. If you 
leave this out, Android will use the name of the application instead. 



The second 
activity was 
automatically 
declared 
because we 


added it using the 
Android Studio wizard. 


The activity declaration may include other properties too, such as 
security permissions, and whether it can be used by activities in other 
apps. 


If you add extra activities 
manually, you’ll need to edit 
AndroidManifest.xml yourself. 
If you use another IDE, it may 
not be added for you. 
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intents 


Aw iwtcwt is a type of message 

So far we’ve created an app with two activities in it, and each activity 
has its own layout. When the app is launched, our first activity, 
CreateMessageActivity, will run. What we need to do next is get 
CreateMessageActivity to call ReceiveMessageActivity 
when the user clicks the Send Message button. 


Whenever you want an activity to start a second activity, you use an intent. 
You can think of an intent as an “intent to do something”. It’s a type of 
message that allows you to bind separate objects (such as activities) together 
at runtime. If one activity wants to start a second activity, it does it by 
sending an intent to Android. Android will start the second activity and 
pass it the intent. 


Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 

You start an activity 
ty creating an 
intent and using it 
in tke startActivityO 
metkoci. 



You can create and send an intent using just a couple of lines of code. You Xhc .m 七⑶七 spcdi-f ics 七 he ad*tWi*ty 

start by creating the intent like this: 如 a 内七* to vcdc'ivc I Vs like 

Intent intent = new Intent (this. Target. class) ; 

The first parameter tells Android which object the intent is from, and r Intent 

you can use the word this to refer to the current activity. The second 
parameter is the class name of the activity that needs to receive the intent. 



Once you’ve created the intent, you pass it to Android like this: 


To ： AnotherActivity 


startActivity(intent); s 

This tells Android to start the activity specified by the intent. 

Once Android receives the intent, it checks everything’s OK and 
tells the activity to start. If it can’t find the activity, it throws an 

ActivityNotFoundException. 


s-ta\rt/\^tiviiyO starts 七 he 
a^tivrty spedi-fied \t\ "the irrt ⑶ t. 



Activityl Android Activity2 
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Use an iwtcwt to start the second activity 

Let’s put this into practice and use an intent to call 
ReceiveMessageActivity. We want to launch the activity 
when the user clicks on the Send Message button, so we’ll add the 
two lines of code to our onSendMessage () method. 

Make the changes highlighted below: 


package com.hfad.messenger; 

import android.app.Activity; 

import android.content.Intent 

import android.os.Bundle; 
import android.view.View; 


l/Vc v\ttd b> irwpo\rt "the 
Irrtejrt dlass 

^ -- droid . 匕0灼七伙七.|灼七伙七 

as v/cVc us’mg i 七 ’… 
o^Scr>d/V]cssajcO. 


public class CreateMessageActivity extends Activity 



r\oi mc*tKod- 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity create message) 


nger 

L a 


Messen 


app/sre/main 

L a 

java 


— I 


com.hfad.messenger 

tu** f*i?] 

” kli• 

CreateMessage 

Activity.java 


//Call onSendMessage() when the button is clicked 
public void onSendMessage(View view) { 

Intent intent = new Intent(this, ReceiveMessageActivity.class); 


startActivity(intent); 


SiaK adiviiy Rcdcivc/WcssajcA^ivi-ty. 


So what happens now when we run the app? 
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what happens 


What happens whew you ruw the app 

Before we take the app out for a test drive, let’s go over how the 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


app we’ve developed so far will function: 



When the app gets 
launched, the main activity, 
CreateMessageActivity starts. 

When it starts, the activity specifies 
that it uses layout activity_create_ 
message, xml. This gets displayed in a 
new window. 




The user clicks on a button. 

The onSendMessage () method 
in CreateMessageActivity 
responds to the click. 



Device 


onSendMessage() 

CreateMessageActivity 



The onSendMessage() method 
tells Android to start activity 
ReceiveMessageActivity using 
an intent. 

Android checks that the 
intent is OK, and then it tells 
ReceiveMessageActivity to 
start. 


onSendMessage() 



Intent 


CreateMessageActivity 


To: Receive 
Message 
Activity 



\nj 

Android 


o: ReceiveMessageActivity 


ReceiveMessageActivity 
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multiple activities and intents 


The story continues... 

When ReceiveMessageActivity 
starts, it specifies that it 
uses layout activity 一 receive 一 
message.xml and this gets 
displayed in a new window. 


O 



CreateMessageActivity 


Device 





\nj 

Android 








activi ty_rece ive—message 


Test drive the app 


Save your changes, and then run the app. CreateMessageActivity 
starts, and when you click on the Send Message button, it launches 
ReceiveMessageActivity. 



12:37 


\/ 

\/ 

V/ 


Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


a message, 

SEND MESSAGE ^ dlidk the Sc^d 

Message burtw 
A little message^^ 





ReceiveMessageActivity 


_ _ _ 一 ♦參 


Hello world! 


you c\\ck oy\ 七 he 
Message button ad*tw*i*ty 

RcdcivcM cssa^cstav-U, ar>d i*b 
activity -Pills i\)t The m 七 he 

layout says w ttcllo >wovld," as is 七 he 

dc-faul*t layout /Udvoid S*tud*io ^avc us. 
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pass text 


Pass text to a second activity 

So far we’ve coded CreateMessageActivity to start 
ReceiveMessageActivity when the Send Message button is 
pressed. Next, we’ll get CreateMessageActivity to pass text to 
ReceiveMessageActivity so that ReceiveMessageActivity 
can display it. In order to accomplish this, we’ll do three things: 




Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



o 

❺ 


Tweak the layout activity_receive_message.xml so that we 
can display the text. At the moment it’s the default 
layout the wizard gave us. 

Update CreateMessageActivity.xml so that it gets the text 
the user inputs. It then needs to add the text to the 
intent before it sends it. 


activity—create— 
message.xml 



Intent 


activity—receive, 
message.xml 



Update ReceiveMessageActivity.java so that it displays the 
text sent in the intent. 


CreateMessage 

Activity.java 


RecieveMessage 

Activity.java 


Lefs start with the layout 

Here’s the activity 一 receive—message.xml layout that Android Studio 
created for us: 


<RelativeLayout xmlns : android= n http :// schemas.android.com/apk/res/android 
xmlns : tools= n http://schemas.android.com/tools" 
android : layout 一 width= n match 一 parent▼' 

android : layout 一 height= n match—parent" Mess 

android : paddingLeft="16dp" 
android : paddingRight= M 16dp" 
android : paddingTop="16dp" 
android : paddingBottom="16 dp" 

tools : context="com.hfad.messenger.ReceiveMessageActivity"> 


□ 

enger 

L a 

app/src/main 


res 


<TGXtVieW Ws 如 

android : text="@string/hello_world M 七亡乂七 vicv/ 七^七 

android: layout_width="wrap_content" apivavs 

android: layout 一 height= n wrap_content n /> ^ ^ layout 

</RelativeLayout> 


□ 

layout 


UUL_ 

__ <%ml> j 


activity_receive. 

message.xml 



We need to make a couple of changes to the layout. We need to give the <Textview> 
element an ID of “message” so that we can reference it in our activity code, and we need to stop 
the String “Hello world!” from appearing. How should we change the layout? Have a go before 
looking at the next page. 
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Update the text view properties 

We need to update a couple of things in the layout. 

First, we need to give the <TextView> element an ID. You 
have to add an ID to any GUI components you need to reference 
in your activity code, as this gives you a way of referencing it in 
your Java code. We also need to stop the text “Hello world!” from 
appearing. 

You can do both these things by updating the layout like this: 



Messen 


nger 

匕 ^― \ 


app/sre/main 


MU 

layout 




activity_receive 

message.xml 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools= n http://schemas.android.com/tools" 
android : layout—width= n match—parent，' 
android : layout—height= n match—parent▼' 
android : paddingLeft="16dp" 
android : paddingRight= M 16dp" 
android : paddingTop= M 16dp" 
android : paddingBottom= M 16dp M 

tools : context= M com.hfad.messenger.ReceiveMessageActivity M > 


<TextView 


^^TiVis ^ivcs 


android:id= n @+id/message M 



*thc <Tc%*t\/iC>w> IP o( message- 

Remove -the -tha-t sets -the ic%i 

— ■to @s-t\rihg/hdlo__wov-ld. 


android : layout_width= M wrap_content" 
android : layout_height= M wrap_content" / > 


</RelativeLayout> 


Rather than delete the code that says 

android : text="@string/hello—world" 

we could have updated strings, xml to give the String 
resource hello—world an empty value. We 
decided not to here as the only text we’ll ever want 
to display in the text view is the message passed to it 
by CreateMessageActivity. 

Now that we’ve updated the layout, we can get to 
work on the activities. 



Do I have to use intents? Can’t I just construct an 
instance of the second activity in the code for my first 
activity? 

That’s a good question, but no, that’s not the “Android 
way” of doing things. One of the reasons is that by passing 
intents to Android, Android knows the sequence in which 
activities are started. This means that when you click on the 
Back button on your device, Android knows exactly where to 
take you back to. 
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extra extra 


putExtraO puts extra information m an iwtewt 

You’ve seen how you can create a new intent using 



Intent intent = new Intent(this. Target.class); 


Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


You can add extra information to this intent that can be picked up by 
the activity you’re targeting so it can react in some way. To do this, you 
use the putExtra () method 

intent.putExtra("message", value); 

where message is a String name for the value you’re passing in, and 
value is the value. The putExtra () method is overloaded so 
value has many possible types. As an example, it can be a primitive 
such as a boolean or int, an array of primitives, or a String. You 
can use putExtra () repeatedly to add numerous extra data to the 
intent. If you do this, make sure you give each one a unique name. 

Howto retrieve extra information from aw intent 

The story doesn’t end there. When Android 
tells ReceiveMessageActivity to start, 

Re ceiveMes sage Activity needs some way of retrieving the 
extra information that CreateMessageActivity sent to Android 
in the intent. 


fuiE^i\raO lets 
you pu 七 c^tv-a 
m-Po\rrwa-tior> \v\ 

七 he message 
youVc 

V To ： ReceiveMessageActivity 
^ message ： ''Hello!” 


Intent 



av-C options 

-Pov- *tKc -type o( value- 

see all m 七 he ^oo^lc 
f[Y\dro\d dodumcv>*tatioy>. f[v\Aro\d 
S*tudlO Will ^'|VC you d lis*t 3s you 
-type dodc *too. 


There are a couple of useful methods that can help with this. The first 
of these is 


getlntent(); 


get Intent () returns the intent that started the activity, and you can 
use this to retrieve any extra information that was sent along with it. 
How you do this depends on the type of information that was sent. As 
an example, if you know the intent includes a String value with a name 
of “message”，you would use the following: 

七 he m 七⑼七 . 

Intent intent = getIntent ();^ 


String string = intent.getStringExtra("message"); 

You’re not just limited to retrieving String values. As an example, you 
can use 


Intent 



To ： ReceiveMessageActivity 
message ： M Hello!” 

I 

ihc passed al<^ 
wi 七 h 七 he m 七⑶七 七 ha 七 has a 


int intNum = intent.getlntExtra("name ", default value); 


to retrieve an int with a name of name, default—value specifies 
what int value you should use as a default. 
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package com.hfad.messenger; 


import 

import 

import 

import 


android.os.Bundle; 
android.app.Activity; 
android.content.Intent; 
android.view.View; 


public class CreateMessageActivity extends 



Paa] Puzz]c 

Your job is to take code segments from 
the pool and place them into the 
blank lines in Crea teM ess age Act i vi ty. 
java. You may not use the same 
code segment more than once, 
and you won’t need to use all 
the code snippets. Your goal is to 
make the activity retrieve text from 


Activity 


the message <EditText> and add it 
to the intent. 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_create_message); 

} 

//Call onSendMessage() when the button is clicked 
public void onSendMessage(View view) { 


Intent intent = new 工 ntent(this, ReceiveMessageActivity.class); 


startActivity(intent); 
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pool solution 


package com.hfad.messenger; 


import 

import 

import 

import 


android.os.Bundle; 
android.app.Activity; 
android.content.Intent; 
android.view.View; 




You Y\ttd bo irwfovt 
-the Bd\iTc%i dlass. 



Paa] puzz]c ^©lufian 

Your job is to take code segments from 
the pool and place them into the 
blank lines in Crea teM ess age A c ti vi ty. 
java. You may not use the same 
code segment more than once, 
and you won’t need to use all 
the code snippets. Your goal is to 
make the activity retrieve text from 


public class CreateMessageActivity extends Activity { 


the message <EditText> and add it 
to the intent. 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_create_message); 


//Call onSendMessage() when the button is clicked 

public void onSendMessage(View view) { 

EditText messageView = (EditText) findViewByld(R.id.message); 

String messageText = messageView.getText().toString(); ^ - 


今 e 七 *bKc 七 e % 七 

-fyom editable 

-f ield 3 ^ 

|P o-f message- 


Intent intent = new 工 ntent(this, ReceiveMessageActivity.class); 


intent.putExtra( // messac|e // , messageText); 


startActivity(intent); 




Add "the {p the iivte 此 
jivmj i-t d o-P ^rwcssajc^. 
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Update the CreateMcssageActivity code 

We updated our code for CreateMessageActivity.java so that it 
takes the text the user enters on the screen and adds it to 
the intent. Here’s the full code (make sure you update your 
code to include these changes, shown in bold): 


multiple activities and intents 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


package com.hfad.messenger; 

import android.os.Bundle; 
import android.app.Activity; 
import android•content•Intent; 
import android.view.View; 

import android.widget.EditText 





M 


public class CreateMessageActivity extends Activity { 

QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity create message); 


You *to imfov 七七 he 

dlass a 灼 dhroid v/idytEditTi 乂七 as 

’ youVc us’ir>3 I 七 m youv* ad*tivt*ty toAt- 


essenger 


app/sre/main 

~Z 3 


java 

LQ 

com.hfad.messenger 

Id 

CreateMessage 

Activity.java 


//Call onSendMessage () when the button is clicked 

public void onSendMessage(View view) { ^ ' 

EditText messageView = (EditText)findViewByld(R.id.message); 

String messageText = messageView.getText().toString(); 

Intent intent = new Intent(this, ReceiveMessageActivity.class); 
intent.putExtra(ReceiveMessageActivity.EXTRA_MESSAGE , messageText); 



startActivity(intent); 

Sta\rt Rc^ivc/l/lcssajcA^iivi-ty 
v/iih 七 he ’nrteKrt. 


Now that CreateMessageActivity has added 
extra information to the intent, we need to retrieve the 
information and use it. 


Cv'Cd'tc 此 3dd 

-to *thc WcVc us*m^ a doy>s*tay>*t 

-Pov- o( i\\t *m-fovmatiov> 

so v/C ky>ov/ Cv"C3*tcA1 v'i*ty 

av\A ^ USI M 

-the same S*tv*m5 - Well add *th'is *to 

RcdcWcMcssa^cA^ v, *ty 内作七 P a 5 c， 


you are here ► 


91 










getStringExtraQ 


fret RGcdveMcssageActivity to use 
the iwformatiow iw the iwtewt 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 


Now that we’ve changed CreateMessageActivity to add 
text to the intent, we’ll update ReceiveMessageActivity 
so that it uses the text. 

We’re going to get ReceiveMessageActivity to display 
the message in its text view when the activity gets created. As the 
activity’s onCreate () method gets called as soon as the activity 
is created, we’ll add the code to this method. 

To get the message from the intent, we’ll first get the intent using 
the getlntent () method, then get the value of the message 
using getStringExtra (). 



Intent _ 


CreateMessage 


RecieveMessage 


Activity.java 

IVc y\ttA bo make 
RctcivcMcssajcA^iiviiy 
deal 七 he m 七 eirt i 七 

v-ctcivcs. 


Activity.java 


Here’s the full code for ReceiveMessageActivity.java (replace the code 
that Android Studio generated for you with this code, and then 
save all your changes): 


package com.hfad.messenger; 

import android.os.Bundle; 
import android.app.Activity; 
import android.content.Intent; 
import android.widget.TextView 



r\ttd *bo imfovi 
| 灼七伙七 3 ir>d 
classes. 


Messen 


nger 


app/sre/main 


java 


public class ReceiveMessageActivity extends Activity { 


public static final String EXTRA_MESSAGE = "message 


U*»s *»s name value v/cVc passmj ’| 士竹七 . 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—receive 一 message); 

Intent intent = getlntent(); 

String messageText = intent.getStringExtra(EXTRA_MESSAGE); 
TextView messageView = (TextView)findViewByld(R.id.message); 
messageView.setText(messageText); 

> ^ 


com.hfad.messenger 

o 

ReceiveMessage 
Activity.java 




与 e 七七 he gei 

"the message *f\rorw •_ 七 us'm^ 


/\dd it%i bo 七 he message viev/. 


Before we take the app for a test drive, let’s run through what the 
code does. 
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multiple activities and intents 


What happens when the user clicks the Send Message button 



When the user clicks on the 
button, the onSendMessage() 
method is called. 

Code within the onSendMessage () 
method creates an intent to start activity 
ReceiveMessageActivity, adds 
a message to the intent, and passes it to 
Android with an instruction to start the 
activity. 


onSendMessage() 


Intent 




CreateMessageActivity 


To ： ReceiveMessage 

Activity 

message ： ,, HiT , 



\nj 

Android 



Android checks that the 
intent is OK, and then tells 
ReceiveMessageActivity to start. 



CreateMessageActivity 


Intent 




To: ReceiveMessage 
Activity 
message: "Hi!” 




\nj 

Android 


ReceiveMessageActivity 



When ReceiveMessageActivity 
starts, it specifies that it uses 
layout activify_receive_message . 
xml, and this gets displayed on 
the device. 

The activity updates the layout so that 
it displays the extra text included in the 
intent. 


1 

Device 


o 

CreateMessageActivity 



activity—receive—message 
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test drive 


K 



Test drive the app 

Make sure you’ve updated the two activities, save your changes, and 
then run the app. CreateMessageActivity starts, and when you 
enter some text and click on the Send Message button, it launches 
ReceiveMes sage Activity. The text you entered is displayed in the 
text view. 


\/ 



Create 1st activity 
Create 2nd activity 
Call 2nd activity 
Pass data 



These av-c bo-th -Pull— 
bui v/c^vc shipped away 
some -the bla^k spade- 


Wc can change the app to send messages to other people 


Now that we have an app that sends a message to another activity, we 
can change it so that it can send messages to other people. We can do 
this by integrating with the message sending apps already on the device. 
Depending on what apps the user has, we can get our app to send messages 
via Messaging, Gmail, Google+, Facebook, Twitter... 


Hey, hold it right there! That 
sounds like a freaky amount of 
work to get the app working with 
all those apps. And how the heck 
do I know what apps people have 
on their devices anyway? Get real. 


It’s not as hard as it sounds due to the way Android is 
designed to work. 

Remember right at the beginning of the chapter when we said that tasks 
are multiple activities chained together? Well, you’re not just limited 
to using the activities within your app. You can go beyond the 
boundaries of your app to use activities within other apps as well. 
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How Android apps work 

As you’ve seen, all Android apps are composed of one or more 
activities, along with other components such as layouts. Each 
activity is a single defined focused thing the user can do. As an 
example, apps such as Gmail, Google+, Messaging, Facebook, and 
Twitter all have activities that enable you to send messages, even 
though they may achieve this in different ways. 


Device 



Eadh is domfoscd o( a 

\)\ay\cM o\ adtivrtics. Ti^cv-c 
^ — 3VC o*tKcv tompcmwts {x>o, 
bu 七 v/cVc jus 七 -fodusm^ oy\ 
七 lie ad 七 Wr&cs \r13ivt y>ov/. 


Intents caw start activities iw other apps 


You’ve already seen how you can use an intent to start a second 
activity within the same app. The first activity passes an intent 
to Android, Android checks it, and then Android tells the second 
activity to start. 


The same principle applies to activities in other apps. You get an 
activity in your app to pass an intent to Android, Android checks it, 
and then Android tells the second activity to start even though it’s in 
another app. As an example, we can use an intent to start the activity 
in Gmail that sends messages, and pass it the text we want to send. 
Instead of writing our own activities to send emails, we can use the 
existing Gmail app. 


Y<>u c^t\ av\ m 七⑶七 *to stav-t 
adiivi-ty i-f 七 he 
adtivi-ty is wrthm a^o-thev- app- 


This is 

i\\t app 

you vc bcc 灼 
v/ovk'm^ oy\ 

*thvou^hou*t 

七 he dl^aftcv-. 




Messenqer 

- Intent 





This means that you can build apps that perform far more powerful 
tasks by chaining together activities across the device. 
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use actions 


Put we dow't know what apps are on the device 


There are three questions we need answers to before we can call activities 
in other apps: 


o 

o 

o 


How do we know activities are available on the user’s device? 

How do we know which of these activities are appropriate for what we want to do? 
How do we know how to use these activities? 


The great news is that we can solve all of these problems using actions. 
Actions are a way of telling Android what standard operations activities 
can perfom. As an example, Android knows that all activities registered for 
a send action are capable of sending messages. 


What you’re going to do next is learn how to create intents that use 
actions to return a set of activities that you can use in a standard way — for 
example, to send messages. 


Here's what you’re going to do 



Create an intent that specifies an action. 

The intent will tell Android you want to use an activity that can send a message. The intent 
will include the text of the message. 



Allow the user to choose which app to use. 

The chances are there’ll be more than one on the device capable of sending messages, so 
the user will need to pick one. We want the user to be able to choose one every time they 
click on the Send Message button. 
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Create aw iwtcwt that specifies an action 


multiple activities and intents 



Specify action 
Create chooser 


So far you’ve seen how to create an intent that launches a specific activity using 


Intent intent = new Intent(this, ReceiveMessageActivity.class); 


The intent is an explicit intent; you explicitly tell Android which class you 
want it to run. 

If there’s an action you want done but you don’t mind which activity does it, you 
create an implicit intent. You tell Android what sort of action you want it to 
perform, and you leave the details of which activity performs it to Android. 


WlcV *told v/iVidh 


dJass I 七 ’s -fov, bu 七 

>wha*t i-f do^*t ky>oy/? 


Howto create the intent 

You create an intent that specifies an action using the following syntax: 


You can iinct out 
more about tke 


Intent intent = new Intent(action); 

where action is the type of activity action you want to perform. Android 
provides you with a number of standard actions you can use. As an example, 
you can use Intent • ACTION—DIAL to dial a number, 

Intent • ACTION—WEB—SEARCH to perform a web search, and 
工 ntent • ACTION—SEND to send a message. So if you want to create an 
intent that specifies you want to send a message, you use 

Intent intent = new Intent(Intent.ACTION SEND); 


Adding extra information 

Once you’ve specified the action you want to use, you can add extra 
information to it. We want to pass some text with the intent that will form the 
body of the message we’re sending. To do this, you use the following lines of 
code: 


sorts oi activity 
actions you can 
use and tke extra 
inioritiation tkey 
support in tke 
Android developer 
reference material ： 
http:/ / tinyurLcom/ 


intent.setType("text/plain"); 

intent.putExtra(Intent.EXTRA 一 TEXT, messageText); 

where messageText is the text you want to send. This tells Android that 
you want the activity to be able to handle data with a MIME data-type of 
“text/plain’’，and also tells it what the text is. 


長 3*t*tv"ibu*tcs v*cla*tc 

ThcyVc Y\oi vclcvair>*t (or 
all ad*tioy>s. 


You can make extra calls to the putExtra () method if there’s additional 
information you want to add. As an example, if you want to specify the subject 
of the message, you can also use 

intent.putExtra(Intent.EXTRA SUBJECT , subj ect );< 


where sub j ect is the message subject. 


I*P subjcdi isr / 七 "to a 

pa\rti£.ubv* app, rt will jus 七 i^o\rc 
•this m-fov-rwa-tio^. f\r^ apps ihai 
k^ow how -to use it v/ill do so. 
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use an action 

Change the mtcwt to use aw action 

We’ll update CreateMessageActivity.java so that we create an implicit 
intent that uses a send action. Make the changes highlighted below, 
and save your work: 



Specify action 
Create chooser 


package com.hfad.messenger; 



import 

import 

import 

import 

import 

public 


android.os.Bundle; 
android.app.Activity; 
android.content. 工 ntent; 


Messenger 



app/sre/main 

Q 


android.view.View; 
android.widget.EditText; 


class CreateMessageActivity extends Activity { 


java 


com.hfad.messenger 

山 “ P«o(l 

CreateMessage 

Activity.java 


QOverride 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_create_message); 


//Call onSendMessage() when the button is clicked 
public void onSendMessage(View view) { 

EditText messageView = (EditText)findViewByld(R.id.message); 
String messageText = messageView.getText().toString(); 


Remove -these 

tv/o I’mes. 



v—TTi"InLent ( 

pputra T s^ q l Q AnF,- 

Intent intent = new Intent(Intent.ACTION—SEND); 
intent.setType( n text/plain"); 

intent.putExtra(Intent.EXTRA TEXT, messageText); 




startActivity(intent); 


Instead <Jc Aa 七 s , 

(oy Rc£.civcA1cssa^cA^*tWi*tY> ^ ^ 
dveatm^ 3^ uses a ad-tion. 


Let’s break down what happens when the user clicks 
on the Send Message button. 
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What happens when the code ruws 


multiple activities and intents 



When the onSendMessage() method 
is called, an intent gets created. 
The startActivityO method passes 
the intent to Android. 

The intent specifies an action of 
ACTION—SEND, and a MIME type of 
text/plain. 


onSendMessage() 


Intent 





CreateMessageActivity 


ACTION—SEND 
type ：、、 text/plain 〃 
messageText: 〃 Hil , 


01 




\nj 

Android 



Android sees that the intent can only 
be passed to activities able to handle 
AC 千 ION—SEND and text/plain data. 
Android checks all the activities, looking 
for ones that are able to receive the 
intent. 

If no actions are able to handle the intent, an 
ActivityNotFoundException is thrown. 



CreateMessageActivity Android 



If just one activity is able to receive 
the intent. Android tells the activity 
to start and passes it the intent. 



CreateMessageActivity 


Intent 



To ： Activity 
messageText:〃HiT 


Activity 



Android 
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what happens 

The story continues... 




Specify action 
Create chooser 



If more than one 
activity is able to 
receive the intent. 
Android displays an 
activity chooser dialog 
and asks the user 
which one to use. 



CreateMessageActivity 


Hey, user. All of 
these activities can 
send a message for you. 
Which one do you want? 




When the user 
chooses the activity 
she wants to use. 
Android tells the 
activity to start and 
passes it the intent. 

The activity displays the 
extra text contained in 
the intent in the body of 
a new message. 



Chosen 

Activity 


In order to create the activity chooser dialog, Android 
must know which activities are capable of receiving the 
intent. On the next couple of pages we’ll look at how it 
does this. 
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multiple activities and intents 


The iwtcwt filter tells Android which 
activities caw handle which actions 

When Android is given an intent, it has to figure out which activity, 
or activities, are able to handle it. This process is known as intent 
resolution. 

When you use an explicit intent, intent resolution is straightforward. 

The intent explicitly says which component the intent is directed 
at, so Android has clear instructions about what to do. As an 
example, the following code explicitly tells Android to start 
ReceiveMessageActivity: 

Intent intent = new 工 ntent(this, ReceiveMessageActivity.class); 
startActivity(intent); 


When you use an implicit intent, Android uses the information in the 
intent to figure out which components are able to receive it. It does this 
by checking the intent filters in every app’s copy of AndroidManifest. xml. 


An intent filter specifies what types of intent each component can 
receive. As an example, here’s the entry for an activity that can handle 
an action of ACTION_SEND. The activity is able to accept data with 
MIME types of text/plain or image: 


This -tells fi[v\dro\d ihc 

〈activity android : name= M ShareActivity"> “l. 

厂 activity handle 

<intent-filter> 〆 ACT 陳一⑽ P. 

<action android:name="android, intent. action. SEND"/> —, , , p.,, 

.TKc \Y\ttY\t +iltcv* 

〈category android : name= M android, intent. category.DEFAULT"/> 帅 5 七 'mdludc 

<data android : mimeType= M text/plain ’▼ / 

<data android : mimeType= n image/*"/> 

</intent-filter 〉 

</activity> 


PEFAWLT ov *i*t 
y/o^*t be able *to 
VCtCiVC implidrt 



These a\rc ihe -types 
o( dd'td "the ad-tivi-ty 


The intent filter also specifies a category. The category supplies extra 
information about the activity such as whether it can be started by a web 
browser, or if it’s the main entry point of the app. An intent filter must 
include a category of android. intent. category. DEFAULT 
if it’s to receive implicit intents. If an activity has no intent filter, or it 
doesn’t include a category name of android. intent. category. 
DEFAULT, it means that the activity can’t be started with an implicit 
intent. It can only be started with an explicit intent using the fully 
qualified component name. 
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intent filters 


Specify action 
Create chooser 


When you use an implicit intent, Android compares the information given 
in the intent with the information given in the intent filters specified in every 
app’s AndroidManifest.xml file. 

Android first considers intent filters that include a category of android. 
intent.category.DEFAULT: 

<intent-filter> 

〈category android : name= M android.intent.category.DEFAULT" / > 


How Android uses the iwtewt filter □ 


</intent-filter> 

Intent filters without this category will be omitted as they can’t receive implicit 
intents. 

Android then matches intents to intent filters by comparing the action and 
MIME type contained in the intent with those of the intent filters. As an 
example, if an intent specifies an action of Intent. ACTION_SEND using: 

Intent intent = new 工 ntent ( 工 ntent•ACTION—SEND); 

Android will only consider activities that specify an intent filter with an action 
of android. intent. action . SEND like this: 

<intent-filter> 

<action android : name= n android•intent.action.SEND" / > 


H will also look -the da^ ： cjov-y o( 
七 he m 七⑶七 -Pilicv- i-f ov\c is supplied 
by "the … 七⑶七 . This isr / 七 used vcv-y 
o\tCY\, so v/c >rt i^o-t ^ovc\r*mg how -to 
add tatcjov-ics -fco’m 七 ents. 


</intent-filter> 

Similarly, if the intent MIME type is set to “text/plain” using 
intent.setType("text/plain"); 

Android will only consider activities that can accommodate this type of data: 
<intent-filter> 

<data android : mimeType= M text/plain" / > 


</intent-filter> 


If the MIME type is left out of the intent, Android tries to infer the type 
based on the data the intent contains. 

Once Android has finished comparing the intent to the component intent 
filters, it sees how many matches it finds. If Android finds a single match, 
Android starts the component (in our case, the activity) and passes it the 
intent. If it finds multiple matches, it asks the user to pick one. 
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multiple activities and intents 


BE th^ fo ㈣ 

Your job is to play Kb you’re 
the intent on the vi^xt and say 
^viucli of the activities described 
below are compatible 
wt&i your action and 
data. Say Ay，or 
not, for each one. 




Here’s {\\c ’m 七⑼ 七 . 


Intent intent = new 工 ntent ( 工 ntent•ACTION—SEND) 
intent.setType("text/plain"); 

intent•putExtra(Intent•EXTRA TEXT, "Hello"); 


〈activity android : name="SendActivity"> 

<intent-filter> 

<action android : name= ▼，android • intent. action . SEND" / > 
〈category android : name= n android.intent.category.DEFAULT" / > 
<data android:mimeType= n */*▼，/> 

</intent-filter 〉 

〈 /activity 〉 


〈activity android : name="SendActivity"> 

<intent-filter> 

<action android : name= ▼▼ android • intent. action . SEND" / > 
〈category android : name="android. intent. category. MAIN'，/> 
<data android : mimeType="text/plain" / > 

</intent-filter> 

〈 /activity 〉 


〈activity android : name="SendActivity"> 

<intent-filter> 

<action android : name= ▼▼ android • intent. action . SENDTO" / > 
〈category android : name="android. intent. category. MAIN'，/> 
〈category android : name= n android.intent.category.DEFAULT " / > 
<data android : mimeType="text/plain" / > 

</intent-filter> 

〈 /activity 〉 
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solution 



BE ^ §©lug©ti 

Your job is to play like you’re the 
ixitent on the ri^rf; and say 
of the activities described below 

are compatible wHli 
your action and 
data. Say why, or 
A^iy not, for each 
one. 


〈activity android : name= M SendActivity M > 
<intent-filter> 


Intent intent = new 工 ntent ( 工 ntent•ACTION—SEND) 
intent.setType("text/plain"); 

intent•putExtra(Intent•EXTRA TEXT, "Hello"); 



This a^tivi-ty ACTIO^BMV 

ha^aie data c^f a^y 如 /p so rt 匕 a” 

vcspohd *to -the … 七⑶七 . 


<action android : name 二 ▼▼ android • intent. action . SEND" / > 


〈category android : name= M android.intent.category.DEFAULT" / > 
<data android:mimeType= n */*，，/> 

</intent-filter 〉 

</activity> 


〈activity android : name="SendActivity"> 
<intent-filter> 


K 


This activity doesht have a category Jc 
DEFAULT SO C^y!{, \rcdcivc -the ihteh 七 . 


<action android : name= ▼▼ android • intent. action . SEND，' / > 
〈category android : name= M android. intent. category. MAIN'，/> 
<data android : mimeType= M text/plain" / > 

</intent-filter> 

</activity> 


〈activity android : name="SendActivity n > 
<intent-filter> 


X 


TW\s a^ivi-ty car^i autyi ACT|0N_S£NP m 七⑶ *U 。七 

ACTION 一 SflVDTO. ACTION^SENPTO allov/s you -to sc^d 
3 *to someone spcti-Picd \y\ s dd'td- 


<action android : name= ▼▼ android • intent. action . SENDTO" / > 
〈category android : name= M android. intent. category. MAIN'，/> 
〈category android : name= M android.intent.category.DEFAULT" / > 
<data android : mimeType= M text/plain" / > 

</intent-filter> 

</activity> 
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You need to ruw your app oh a REAL device 




Specify action 
Create chooser 


So far we’ve been running our apps using the emulator. The emulator 
only includes a small number of apps, and there may well be just one app 
that can handle AGTION_SEND. In order to test our app properly, we 
need to run it on a physical device where we know there’ll be more than 
one app that can support our action — for example, an app that can send 
emails and an app that can send messages. 

Here’s how you go about getting your app to run on a physical device. 


1. Enable US? debugging ow your device 

On your device, open “Developer options” (in Android 
4.0 onward, this is hidden by default). To enable it, go to 
Settings About Phone and tap the build number seven 
scviously.—^ times. When you return to the previous screen, you should 
be able to see “Developer options.” 

Within “Developer options,” tick the box to enable USB 
debugging 

ha need io enable USB 


Z. Setup your system to detect your device 

If you’re using a Mac, you can skip this step. 

If you’re using Windows, you need to install a USB driver. You can 
find the latest instructions here: 

http:/ / developer, android, com/tools/extras/oem-usb. html 

If you’re using Ubuntu Linux, you need to create a udev rules file. 
You can find the latest instructions on how to do this here: 


• 

^ A Q 14:35 

<r Developer options 

A 

On 


Geeky stats about running processes 

^ - - 


Debugging 


USB debugging 

3 

iv Debug mode when USB is connected 

N — _ 


Revoke USB debugging authorisations 


Bug report shortcut 

Show a button in the power menu for taking a 口 
bug report 


Allow mock locations 

Allow mock locations 


Enable view attribute inspection 
Select debug app 


□ 


□ 


http:/ / developer, android, com/tools/device. html#setting-up 


$. Plug your device into your computer with a USP cable 


Your device may ask you if you want to accept an RSA key that allows USB 
debugging with your computer. If it does, you can tick the “Always allow from 
this computer’’ option and choose OK to enable this. 



You II yt 七 his message 
i-f youv device is 
/Udvo’id ov 
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running on real devices 

Runnmg your app on a real device (contmued) 


Specify action 
Create chooser 


4. Rim your app m Android Studio as normal 

Android Studio will install the app on your device and launch it. You may be 
asked to choose which device you want to run your app on. If so, select your 
device from the list available and click OK. 


8 n o 


Choose Device 


■ Choose a runming device 


Device 


Serial Number 


The -fivs-t 
device listed is 

ou\r cr^ula-to\r. Emuiator N:exus 4 API Z1 Android S.O CAPI Zl) emubtor-55S4 

ttcvc^s ouv jL 
p^ysidal dcvidc ^' 


LGE Nexus 4 Android %.Q [API 2 1) 


009Bf1aQd!53a6a3e 



Launch emutator 


Android virtual device: 


Use same device for future launches 


And here's the app rwvimq 
ow the physical device 

You should find that your app looks about the same 
as when you ran it through the emulator. You’ll 
probably also find that your app installs and runs 
quicker too. 

Now that you know how to run the apps you create 
on your own device, you’re all set to test the latest 
changes to your app. 
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multiple activities and intents 


Test drive the app 



Try running the app using the emulator, and then using your own 
device. The results you get will depend on how many activities you have 
on each that support using the Send action with text data. 


If you have owe activity 

Clicking on the Send Message button will take 
you straight to that app. 

Wc ortly have oY\t adtivrty available 
oy\ cmulaiov- scy>d ^ 

messages w’rth d3"tci> SO v/C 

dlidk oy\ £cir>d Message button 
hv\Aro\d stav-b i\\t adtivi-ty. 


SEND MESSAGE 


A little message! 


If you have wore thaw owe activity 


^-0 一 


。 New message 


卜 o 




Android displays a chooser and asks you to pick which one you want 
to use. It also asks you whether you want to use this action just once 
or always. If you choose always, the next time you click on the Send 
Message button it uses the same activity by default. 


Here’s 七 he message- 


A little message 


14:29 


SEND MESSAGE 


A little message! 



14:32 


Share with Messaging 



Wlc have lots of suitable activities available 
ou\r physical device. Wc deeded io use 
七 he /Vlcssajmj app. Wt stlcticd i\\t “always” 
option—j\rca-t i-f wc always -to use 
Messaging, Y\oi so j\rca-t i-P v/c io use 
a d\((trcv\i ov\c eadh -time- 


JUST ONCE ALW/ 



▼ 

A Q 

14:33 | 


New message ^ 

b 

■ 

■ 

■ 


message's messages messaged 

1 2 3 4 5 6 7 8* 

q w e r t y u i o 


a s d f g h j k 


z x c v 


n m 


?123 


Use a 

different app 

Q 

Hangouts 

M 

Gmail 

B 

Any.do 

B 

Add Recipe to MyFitnessPal 


Add to Dropbox 

# 

Android Beam 

0 

Bluetooth 



To 


> 


A little message 

123456789 0 | 

qwertyuiop 
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let the user choose 


What if you ALWAYS wawt your users to choose an activity? 


You’ve just seen that if there’s more than one activity on 
your device that’s capable of receiving your intent, Android 
automatically asks you to choose which activity you want to use. It 
even asks you whether you want to use this activity all the time or 
just on this occasion. 

There’s just one problem with this default behavior: what if you 
want to guarantee that users can choose an activity every time they 
click on the Send Message button? If they’ve chosen the option to 
always use Gmail, for instance, they won’t be asked if they want to 
use Twitter next time. 

Fortunately, there’s a way around this. You can create a chooser 
that asks you to pick an activity without asking if you always want 
to use it. 


createCkooserO allows 
you to speciiy a title ior 
tke ckooser dialog and 
doesn’t give tke user 
tke option ol selecting 
an activity to use ty 
default. It also lets tke 


Iwtewt.createChooserO displays a chooser dialog 

You can achieve this using the 工 ntent • createChooser () 
method. This method takes the intent you’ve already created, 
and wraps it in a chooser dialog. The big difference in using this 
method is that you’re not given the option of choosing a default 
activity — you get asked to choose one every time. 


user know ii tkere are 
no matekingf activities 
hy displaying a message. 


You call the createChooser () method like this: ^TW\s is *tKc you dvca*tcd cav-licv-. 

V 

Intent chosenlntent = Intent•createChooser(intent, "Send message 

K ： 

The method takes two parameters: an intent and an optional 
String title for the chooser dialog window. The 工 ntent 
parameter needs to describe the types of activity you want the 
chooser to display. You can use the same intent we created earlier, 
as this specifies that we want to use ACTION—SEND with textual 
data. 


^ ^ pass \y\ a ii-tlc -Po\r ihc 

dhoosev iha-t jets displayed a 七七 he 

top o( 七 he 


The createChooser () method returns a brand-new Intent. 
This is a new explicit intent that’s targeted at the activity chosen by 
the user. It includes any extra information supplied by the original 
intent, including any text. 

To start the activity the user chose, you need to call 


startActivity(chosenlntent); 


We’ll take a closer look over the next couple of pages at what 
happens when you call the createChooser () method. 
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What happens when you call crcatcChooscrO 


multiple activities and intents 



Specify action 
Create chooser 


This is what happens when you run the following two lines of code: 


Intent chosenlntent = Intent•createChooser(intent, "Send message 
startActivity(chosenIntent); 



The createChooser() method 
gets called. 

The method includes an intent that 
specifies the action and MIME type 
that’s required. 


createChooser() 


Intent 


ACTION—SEND 
type ：、、 text/plain 〃 

CreateMessageActivity message: 〃 Hi1 〃 






Android checks which activities 
are able to receive the intent 
by looking at their intent 
filters. 

It matches on the actions, type of data, 
and categories they can support. 


I see, I need to 
create a chooser for 
activities that support 
the SEND action and 
text/plain data. 



CreateMessageActivity 



Android 



If more than one activity is 
able to receive the intent. 
Android displays an activity 
chooser dialog and asks the 
user which one to use. 

This time it doesn’t give the user the 
option of always using a particular 
activity, and it displays “Send 
message...” in the title. 

If no activities are found, Android 
still displays the chooser but shows a 
message to the user telling her there 
are no apps that can perform the 
action. 



User 
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what happens 


The story continues... 


V 


Specify action 
Create chooser 



When the user chooses 
which activity she wants to 
use. Android returns a new 
explicit intent describing 
the chosen activity. 

The new intent includes any 
extra information that was 
included in the original intent, 
such as any extra text. 



CreateMessageActivity 


ChosenActivity 

message:"!^!’’ 


r O J 

Android 



User 



The activity asks 
Android to start the 
activity specified in 
the intent. 


Thanks for the intent, 
Android. Can you start 
the activity now, bud? 


0 


Intent 




To: ChosenActivity 
message ： ,, HiT , 


CreateMessageActivity 





\nj 

Android 



Android asks the 
activity specified by 
the intent to start, 
and then passes it the 
intent. 



CreateMessageActivity 


Intent 






To ： ChosenActivity 
message 


vu 

Android 


ChosenActivity 
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multiple activities and intents 


Change the code to create a chooser 


We’ll change the code so that the user gets asked which activity they want to use 
to send a message every time they click on the Send Message button. We’ll update 
the onSendMessage () method in CreateMessageActivity.java so that it calls the 
createChooser () method, and we’ll add a string resource to strings.xml for the 


chooser dialog title. 

Update striwgs.xml... 

We want the chooser dialog to have a title of “Send message...”• Add 
a string called “chooser” to strings.xml, and give it the value “Send 
message...” (make sure to save your changes): 


□ 

Messenger 



app/sre/main 


<string name= n chooser M >Send message...</string> 
• • • 

and update the onSendMessageO method 


res 



val 


ues 


l<^rwl>l 


strings.xml 


We need to change the onSendMessage () method so that it 
retrieves the value of the chooser string resource in strings.xml, calls 
the createChooser () method, and then starts the activity the 
user chooses. Update your code as follows: 



//Call onSendMessage() when the button is clicked 


app/sre/main 


public void onSendMessage(View view) { 

EditText messageView = (EditText)findViewByld(R.id.message); 
String messageText = messageView.getText().toString(); 

Intent intent = new 工 ntent ( 工 ntent•ACTION—SEND); 



com.hfad.messenger 

山 " F«*(l 


intent.setType("text/plain"); 

intent•putExtra(Intent•EXTRA—TEXT, messageText); 

String chooserTitle = getString(R.string.chooser); - 4 ^ 


6\ti the 

dKooscv- 


CreateMessage 

Activity.java 


Intent chosenlntent = Intent.createChooser(intent, 


startActivity(chosenlntent); ^ 


S*tav 七七 ad*t*iv*i*ty 
七 usev sclcticd- 


chooserTitle); 

Display -the dhoosc\r didlo^. 


The getString () method is used to get the value of a string resource. It takes 
one parameter, the ID of the resource (in our case, this is R. string. chooser): 

getString (R. string. chooser) ; ^ y ou ^ R you II -fmd dhoosev- 

the \v\Y\cy dlass called s-tv-mg. 

Now that we’ve updated the app, let’s run the app to see our chooser in action. 
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test drive 



Test drive the app 


Save your changes, then try running the app again. 


\/ 

\/ 


Specify action 
Create chooser 


If you have owe activity 

Clicking on the Send Message button will take 
you straight to that app just like before. 


Thcv-c^s y\o 一 

A^dv-oid -fco take 

you sivaighi b> the atiivi-ty. 



SEND MESSAGE 


A little message 




。 New message 


To 






If you have wore thaw owe activity 

Android displays a chooser but this time it doesn’t ask us if we always 
want to use the same activity. It also displays the value of the chooser 
string resource in the title. 


A little message 



Hcvcs i\\t cMoostr heated 

\i ^ives us oftio^ 

usmg a pavtidulav a^Wrty cvevy time. 


SEND MESSAGE 


A little message! 


message's messages messaged 

• •眷 

123456789 

q w e r t y u i o 


a s d f g h j k 


Send message... 

P 

Messaging 

9 

Hangouts 

M 

Gmail 

B 

Any.do 

B 

Add Recipe to MyFitnessPal 


Add to Dropbox 


• 

擎 

j Q 


New message ^ 

b 


14:46 


■ 

■ 

■ 



To 
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A little message 

1234567890 

qwertyuiop 
a s d f g h j k I 







































multiple activities and intents 


If you have NO matching activities 


If you have no activities on your device that are capable of sending 
messages, the createChooser () method lets you know by 
displaying a message. 

This behavior is another benefit to using the createChooser () 
method. The createChooser () method is able to deal with 
situations where no activities can perform a particular action. 

l*P you io ^rcplida-tc -this -Pov 

■bry the app m 七 he cmulaW, av\d 

disable -the /Wcssajmj app -tha-t's oy\ ihcv-c- 



tJiereiare no 。 

Dumb Questi9ns 


So I can run my apps in the 
emulator or on a physical device. Which 
is best? 

Each one has its pros and cons. 

If you run apps on your physical device, 
they tend to load a lot quicker than using 
the emulator. It’s also useful if you’re 
writing code that interacts with the device 
hardware. 

The emulator allows you to run apps 
against many different versions of 
Android, screen resolutions, and device 
specifications. It saves you from buying lots 
of different devices. 

The key thing is that you make sure you 
test your apps thoroughly using a mixture 
of the emulator and physical devices before 
releasing them to a wider audience. 


Should I use implicit or explicit 
intents? 

It comes down to whether you need 
Android to use a specific activity to perforin 
your action, or whether you just want the 
action done. As an example, suppose you 
wanted to send an email. If you don’t mind 
which email app the user uses to send it, 
just as long as the email gets sent, you’d 
use an implicit intent. On the other hand, if 
you needed to pass an intent to a particular 
activity in your app, you’d need to use an 
explicit intent. You need to explicity say 
which activity needs to receive the intent. 

You mentioned that an activity’s 
intent filter can specify a category as 
well as an action. What’s the difference 
between the two? 


An action specifies what an activity 
can do, and the category gives extra 
detail. We’ve not gone into details about 
the category because you don’t often need 
to specify a category when you create an 
intent. 

You say that the 

createChooser () method 
displays a message in the chooser 
if there are no activities that can 
handle the intent. What if I’d just 
used the default Android chooser 
and passed an implicit intent to 
startActivity()? 

If the startActivity () 

method is given an intent where 
there are no matching activities, an 
ActivityNotFoundException 
is thrown. If you don’t catch this using a 
try/catch block, it may cause your 
app to crash. 
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toolbox 



and intents to your toolbox. 


You’ve got Chapter 3 under 
your belt and now you’ve 
added multiple activity apps 


Your Android Toolbox 


You download 
-full code ^ov 

i\\t 


rtcadF*»v-stA^dv-o*id. 



BULLET POINTS 


■ A task is two or more activities chained together. 

■ The <EditText> element defines an editable text field for entering text. It inherits from the Android view class. 

■ You can add a new activity in Android Studio by choosing File ^ New... ^ Activity. 

■ Each activity you create must have an entry in AndroidManifest.xml. 

■ An intent is a type of message that Android components use to communicate with one another. 

■ An explicit intent explicitly specifies the component the intent is targeted at. You create an explicit intent using 

Intent intent = new 工 ntent(this. Target.class); 

■ To start an activity, call startActivity (intent) . If no activities are found, it throws an 

ActivityNotFoundException. 

■ Use the putExtra () method to add extra information to an intent. 

■ Use the get intent () method to retrieve the intent that started the activity. 

■ Use the get*Extra () methods to retrieve extra information associated with the intent. 
getStringExtra () retrieves a String, getintExtra () retrieves an int, and so on. 

■ An activity action describes a standard operational action an activity can perform. To send a message, use 

工 ntent•ACTION_SEND. 

■ To create an implicit intent that specifies an action, use 

Intent intent = new Intent (action); 

■ To describe the type of data in the intent, use the setType () method. 

■ Android resolves intents based on the named component, action, type of data, and categories specified in the 
intent. It compares the contents of the intent with the intent filters in each app’s AndroidManifest.xml. An activity 
must have a category of default if it is to receive an implicit intent. 

■ The createChooser () method allows you to override the default Android activity chooser dialog. It allows you 
to specify a title for the dialog, and doesn’t give the user the option of setting a default activity. If no activities can 
receive the intent it is passed, it displays a message. The createChooser () method returns an intent. 

■ You retrieve the value of a string resource using getstring (R. string. stringname )； 
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Activities form the foundation of every Android app. 

So far you’ve seen how to create activities, and made one activity start another using an 
intent. But what’s really going on beneath the hood? In this chapter, we’re going to dig 
a little deeper into the activity lifecycle. What happens when an activity is created and 
destroyed? Which methods get called when an activity is made visible and appears in 
the foreground, and which get called when the activity loses the focus and is hidden? 
And how do you save and restore your activity’s state? 


this is a new chapter 
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how activities work 


How do activities really work? 


So far you’ve seen how to create apps that interact with the user, 
and apps that use multiple activities to perform tasks. Now that you 
have these core skills under your belt, it’s time to take a deeper look 
at how activities actually work. Here’s a recap of what you know so 
far, with a few extra details thrown in. 


o An app is a collection of activities, layouts, and other resources 

One of these activities is the main activity for the app. 


Bach afp Kas a ， 一 / 

as spcdi-f'icd *tV>c -f ile 




By default, each app runs within its own process. 

This helps keep your apps safe and secure. You can read more about this in Appendix i 
(which covers the Android runtime, or ART) at the back of this book. 


Process 1 


Appl 


o 

Activity 

o 

Activity 


o 

Activity 

o 

Activity 


o 

Activity 

o 

Activity 


Process 2 
App 2 


O 

Activity 
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the activity lifecycle 



You can start an activity in another application by passing an intent 

with start Act ivityO. 

The Android system knows about all the installed apps and their activities, and uses the 
intent to start the correct activity. 


Appl 



startActivityO 



Intent 




When an activity needs to start. Android checks if theres already a 
process for that app. 

If one exists, Android runs the activity in that process. If one doesn’t exist, Android 
creates one. 


I’m already running 
activities for this app 
in process 1. I’ll run 
this one there too. 



Process 1 


Appl 



o 



When Android starts an activity, it calls its onCreate() method. 

onCreate () is always run whenever an activity gets created. 



Android 


onCreate() 




Activity 


But there are still lots of things we don’t yet know about how activities 
function. How long does the activity live for? What happens when 
your activity disappears from the screen? Is it still running? Is it still 
in memory? And what happens if your app gets interrupted by an 
incoming phone call? We want to be able to control the behavior of 
our activities in a whole range of different circumstances, but how? 


App 2 



Activity 
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stopwatch 


The Stopwatch app 

In this chapter, we’re going to take a closer look at how activities 
work under the hood, common ways in which your apps can 
break, and how you can fix them using the activity lifecycle 
methods. We’re going to explore the lifecycle methods using a 
simple Stopwatch app as an example. 


The Stopwatch app consists of a single activity and a single 
layout. The layout includes a text view showing you how much 
time has passed, a Start button that starts the stopwatch, a Stop 
button that stops it, and a Reset button that resets the timer 
value to zero. 


09:05 


0:00:09 



START 


STOP 




RESET ^ - ■ 


his is y>umbcv* 
-f sttoY\As- 


l/Vhch you dlidk oh the 
S*ta\rt but-fcoh, the sedohds 
begih -fco 

you dlitk oy\ 

S*top button, stCor\As 
s*bof 'md\rcmcr\tm5- 

W\\cy\ you dlidk oy\ *tKc 
Rcsc*t buttojr^ 
sedo^ds joes badk *to O. 


Wild the app 

You have enough experience under your belt to build the app 
without much guidance from us. We’re going to give you just 
enough code to be able to build the app yourself, and then you 
can see what happens when you try to run it. 


Start off by creating a new Android project for an application 
named “Stopwatch” with a package name of com. hf ad. 
stopwatch. The minimum SDK should be API 15 so 
it can run on most devices. You’ll need an activity called 
“StopwatchActivity” and a layout called “activity—stopwatch”. 
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the activity lifecycle 


The stopwatch layout code 

Here’s the XML for the layout. It describes a single text view that’s used to 
display the timer, and three buttons to control the stopwatch. Replace the 
XML currently in activity_stopwatch.xml with the XML shown here: 


r*v 



<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android 
xmlns : tools="http :// schemas.android.com/tools" 
android: layout—width= n match—parent，' 
android:layout—height= n match—parent n 
android:paddingBottom=" 16 dp" 
android:paddingLeft=" 16 dp" 
android:paddingRight= M 16 dp M 
android:paddingTop=" 16 dp" 
tools : context=".StopwatchActivity" > 


Stopwatch 

KU 


app/sre/main 

Q 


<TextView 

android : id= n @+id/time view' 


Wlc’ll use 七 his v*ic>w *to 
display 七 he y>umbcv o( sctoY\ds. 


res 


□ 

layout 


UUL 

</ 


activity— 
stopwatch.xml 


android : layout—width:"wrap 一 content" 
android : layout—height= n wrap 一 content” 
android : layout_alignParentTop="true" 
android : layout_centerHorizontal="true n 
android : layout_marginTop= M Odp" 
android : text="" 


android : textAppearance= n ?android:attr/textAppearanceLarge' 
android:textSize= n 92sp n /> ^_^ 

^ ^ These atbribu 七 es make -the 

s-topv/a-tdh 七 irweV" big. 


<Button 

android : id="@+id/start—button n 
android : layout 一 width: n wrap 一 content" ^ 
android : layout_height= n wrap—content” 
android : layout_below= n @+id/time_view" 
android : layout_centerHorizontal= M true" 
android : layout_marginTop= M 2 Odp 
android:onClick= n onClickStart" 
android : text="@string/start" /> 


This is -fov* ■七 

button. I 七 dalU a mc*tiiod 

dalled o 灼 CUS*tav 七 0 
⑶ ••七 dl'idkcd- 


The layoui 
Code dojvt’mues 
ovc\r 七 he page- 
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layout code 


The layout code (contmued) 

<Button 

android : id= n @+id/stop 一 button" 
android : layout_width= n wrap—content” 
android : layout_height= n wrap 一 content” 
android : layout—below= n @+id/start—button” 
android : layout_centerHorizontal= n true n 
android : layout_marginTop="10dp M 
android : onClick= n onClickStop M ' 

android:text= n @string/stop" /> 


□ 

Stopwatch 

app/sre/main 

L a 


TKis is -fov S*tof 
buttoirv I 七 tails a 
me 七 iiod ddlledi 
oy>CI*itkS*topO 
•rt yts disked- 



activity_ 
stopwatch.xml 


<Button 


This is (or ihc Rcsci bui-to^. 

android: id= n @+id/reset—button ，， ^ G" s ^CI'^kRcsctO y/hen 

android : layout—width= n wrap—content’ 
android : layout_height= n wrap—content” 
android : layout_below= n @+id/stop—button” 
android : layout_centerHorizontal="true' 
android : layout_marginTop="10dp' 
android : onClick= n onClickReset' 
android:text= n @string/reset" /> 



</RelativeLayout> 


The stopwatch strings.xml file 


The layout uses three extra String values, one for the text value of each 
button. These values are String resources, so need to be added to strings, 
xml. Add the string values below to strings, xml: 


<string name= n start">Start</string> 
<string name="stop">Stop</string> 
<string name= n reset">Reset</string> 



辛 


this! 

平 

Make sure you update 
the layout and strings, 
xml in your app before 
continuing. 


□ 

Stopwatch 


These avc 
butto 灼 labels. 


L d 

app/sre/main 

■_I 


res 



The layout is done! Next, let’s move on to the activity. 


values 

l <Am '3 

strings.xml 
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the activity lifecycle 


How the activity code will work 

The layout defines three buttons that we’ll use to control 
the stopwatch. Each button uses its onClick attribute 
to specify which method in the activity should run when 
the button is clicked. When the Start button is clicked, the 
onClickStart () method gets called, when the Stop 
button is clicked the onClickStop () method gets called, 
and when the Reset button is clicked the onClickReset () 
method gets called. We’ll use these method to start, stop, and 
reset the stopwatch. 


09:05 


L 


0:00:09 


START 



iVheh you dlid Oh the stav-l buWoh 
the ohCli^kS-ta\rtO method is ^lled. 

W\\tv\ you dlitk or\ S*tof button ， 
or\Cli^k£*tofO method is tailed- 


tVhcn you dlidk oy\ Rcsc*t 

o^ClidkRcsc*tO method is dalled- 


We’ll update the stopwatch using a method we’ll create called 
runTimer () . The runTimer () method will run code 
every second to check whether the stopwatch is running, 
increment the number of seconds and display the number of 
seconds in the text view. 

To help us with this, we’ll use two private variables to record 
the state of the stopwatch. We’ll use an int called seconds 
to track how many seconds have passed since the stopwatch 
started running, and a boolean called running to record 
whether the stopwatch is currently running. 

We’ll start by writing the code for the buttons, and then we’ll 
look at the runTimer () method. 


runTimerQ 


CO 


Activity 
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buttons 


Add code for the buttons 

When the user clicks on the Start button, we’ll set the running variable 
to true so that the stopwatch will start. When the user clicks on the 
Stop button, we’ll set running to false so that the stopwatch stops 
running. If the user clicks on the Reset button, we’ll set running 
to false and seconds to 0 so that the stopwatch is reset and stops 
running. 

Replace the contents of StopwatchActivity.java with the code below: 


package com.hfad.stopwatch; 

import android.os.Bundle; 
import android.app.Activity; 
import android.view.View; 

public class StopwatchActivity extends Activity { 



^ running=true 


running=false 


running=false 

seconds=0 


Stopwatch 

app/sre/main 


... , n 一 Use scdoy>ds dr>d *to vedovd 

private int seconds = 0; r J , , 

, - ■ / y^urwbev- ok sedor^ds Passed ^y\(X 

private boolean running; . ,, , ,. 

>whc*thcv- tht stofv/atdh is vuymmi 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity stopwatch); 


java 


CjI 

com. hfad. stopwatch 


山 “ F**(I 


Stopwatch 

Activity.java 


//Start the stopwatch running when the Start button is clicked, 
public void onClickStart(View view) { 



TVis acts called y/b 

running = true; ^ the mm ••吩 bu*tU is didked- 


//Stop the stopwatch running when the Stop button is clicked. 

public void onClickStop (View view) { 之 This yts called y/hert 七 he 

running = false — ±L , . , S-fcoP button is dlidked- 

. tnc \ruhhih(\. 


//Reset the stopwatch when the Reset button is clicked, 
public void onClickReset (View view) { ^ ^丁心 $ 士 called 

£*tof s*fcopy/3*t^h v/h ⑼七 he Rcsc*t 

vur>v>m^ diad sc*t 

scdoy>ds *to 0 . 


running = false; 
seconds = 0; 



bu*bton is di 乙 kedL 


122 Chapter 4 













the activity lifecycle 


The ruwTimcrO method 


The next thing we need to do is create the runTimer () method. 
The runTimer () method will get a reference to the text view in 
the layout, format the contents of the seconds variable into hours, 
minutes, and seconds, and then display the results in the text view. If 
the running variable is set to true, it will increment the seconds 
variable. Here’s the code: 


private void runTimer() { 

final TextView timeView = 


广 viow. 

(TextView) findViewByld(R. id. time view); 


Ic-Pi 

oui a bii o( 
CoAt hc\rc- 
I/Vcll look ai 

-that OY\ the 

灼 page- 



int hours = seconds/3600; 
int minutes = (seconds%3600)/60; 
int secs = seconds%60; 

String time = String.format("%d:%02d:%02d' 
hours, minutes , secs); 
timeView. setText (time); 
if (running) { 


- Sc*t viev/ 


seconds++; is i\ruc, 

"the seto^ds variable- 


FoV"rw3"t "the m*feo houvs, 

rwi^u'tcs, This is 

plam Java Code 


We need this code to keep looping so that it increments the seconds 
variable and updates the text view every second. We need to do this in 
such a way that we don’t block the main Android thread. 

In non-Android Java programs, you can perform tasks like this using a 
background thread. In Androidville, this is a problem — only the main 
Android thread can update the user interface, and if any other thread 
tries to do so, you get a CalledFromWrongThreadException. 

The solution is to use a Handler. We’ll look at this on the next page. 
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handlers 


Handlers allow you to schedule code 

A Handler is an Android class you can use to schedule code that 
should be run at some point in the future. You can also use it to post 
code that needs to run on a different thread. In our case, we’re going 
to use a Handler to schedule the stopwatch code to run every second. 

To use the Handler, you wrap the code you wish to schedule in 
a Runnable object, and then use the Handler post () and 
postDelayed () methods to specify when you want the code to run. 
Let’s take a closer look at these mehods. 


The postO method 

The post () method posts code that needs to be run as soon as 
possible (which is usually almost immediately). The post () method 
takes one parameter, an object of type Runnable. A Runnable 
object in Androidville is just like a Runnable in plain old Java, 
a job you want to run. You put the code you want to run in the 
Runnable’s run () method, and the Handler will make sure the 
code is run as soon as possible. Here’s what the method looks like: 

final Handler handler = new Handler(); 

handler. post (Runnable) ; ^^y^ ou ^ 七 七 he todt you *to vuy> Hairullcv-^s vur>0 mrti^od. 


The postPelayedO method 


The postDelayed () method works in a similar way to the post () 
method except that you use it post code that should be run in the 
future. The postDelayed () method takes two parameters: a 
Runnable and a long. The Runnable contains the code you want 
to run in its run () method, and the long specifies the number of 
milliseconds you wish to delay the code by. The code will run as soon 
as possible after the delay. Here’s what the method looks like: 


final Handler handler = new Handler(); 


handler.postDelayed(Runnable, 


long) ; ^ — Use "this rwc*thod "to dclsy 6odc 

by a spedi-fied r^urwbev* or millisedo^cls. 


On the next page, we’ll use these methods to update the stopwatch 
every second. 
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The full ruwTimcrO code 

To update the stopwatch, we’re going to repeatedly schedule code using 
the Handler with a delay of 1,000 milliseconds each time. Each time the 
code runs, we’ll increment the seconds variable and update the text view. 

Here’s the full code for the runTimer () method: 


private void runTimer() { 


final TextView timeView = (TextView)findViewByld(R.id•time—view); 


final Handler handler = new 
handler.post(new Runnable() 
@Override 

public void run() { 


Handler () ; 一 Cv*c3*tc 3 r\CVJ Ha^dlcv*. 

{ Call "the fos-tO mctliod, d Ruirmable. The pos 七 0 

rwciliod p\rodcsscs Codes v/iihoui a delay, so -the Code m ihe 
Ru^ablc will \rur> alrwos-t irwrwcdia'tcly. 


int hours = seconds/3600; 


})； 


int minutes = (seconds%3600) / 60; 
int secs = seconds%60; 

String time = String.format("%d:%02d:%02d" f 
hours , minutes, secs); 
timeView.setText(time); 
if (running) { 
seconds++; 


The Ru^able v-uir>0 mcihod 

ou *to 
*thc CoAt 
-to ufda*tc ihc viev/. 


^ — doy>*ta'ms 七 V>c todc y 
be v*uy> 一 m ouv* ddsc ; 


handler.postDelayed(this, 1000) ; ><^—Posi ihc Code m 七 he Ru^^able {jo be V'urt a^a'm 

a*P"te\r a delay of 1,000 miHisc^ds, ov / second- 
As *tliis lihC o( to At is mdludcd \v\ "the Ru^i^dblc 
\ruhO rweihod , 七 his will keep gciimj 匕 ailed. 


Using the post () and postDelayed () methods in this way means 
that the code will run as soon as possible after the required delay, which 
in practice means almost immediately. While this means the code will lag 
slightly over time, it’s accurate enough for the purposes of exploring the 
lifecycle methods in this chapter. 

We want the runTimer () method to start running when 
StopwatchActivity gets created, so we’ll call it in the activity 
onCreate () method: 

protected void onCreate(Bundle savedlnstanceState) { 


runTimer(); 


We’ll show you the full code for the activity on the next page. 
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StopwatchActivity code 


The full StopwatchActivity code 

Here’s the full code for StopwatchActivity.java. Update your code with our 
changes below. 


package com.hfad.stopwatch; 

import android.os.Bundle; 
import android.os.Handler; 
import android.app.Activity; 
import android.view.View; 
import android.widget.TextView; 


public class StopwatchActivity extends Activity { 

/ /Number of seconds displayed on the stopwatch. 


□ 

Stopwatch 

L C3 

app/src/main 

L n 



com. hfad. stopwatch 

Q 

Stopwatch 

Activity.java 


private mt seconds = 0; Msc scdoy>d s a^d bo rttord 

//Is the stopwatch running? ike o( sttov\As passed By\A 

private boolean running; ^ S'topwa'ttK is 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 

setContentView(R.layout.activity—stopwatch); 

runTimer(>; 冬 、 " 

、鞭 usmj a separate method -to 

} upda-tc -the s-topwa-Uh. IVcVc stavtmg \i 

v/he 灼七 he adiiviiy is dvcaicd. 


//Start the stopwatch running when the Start button is clicked. 
public void onClickStart(View view) { 

running = true; ^ giari tKc 如卜 aidh mm 峋 . SWt butU is dM 



This acts called v/V^ 


//Stop the stopwatch running when the Stop button is clicked. 

public void onClickStop (View view) { - This jets tailed ihc 

running = false; , . S-top bu^tto 灼 is didlced. 

tnc stopwatch vuhh’mg. 
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The activity code (cowtiwued) 


/ /Reset the stopwatch when the Reset button is clicked. 
public void onClickReset(View view) { 



running 

seconds 


3 七 

0 ’ — \ruymm3 sc*t 七 he 

scdov>ds *fco O. 


This yb 
dalled >wV>cir> 
the Rcsc*t 
bu*t*bor> is 
dl'idkcd- 


Stopwatch 

L D 

app/sre/main 


java 


com. hfad. stopwatch 

LJZh 

f»kli ‘…喔 

Stopwatch 
Activity.java 


//Sets the number of seconds on the timer. 十七七 he 七以七 vie>w 

private void runTimer() { 

final TextView timeView = (TextView)findViewByld(R.id.time_view); 
final Handler handler = new Handler(); 

handler, post (new Runnable () { Msc a Handler io fosi dodc- 

@Override 

public void run() { 

int hours = seconds/3600; 

int minutes = (seconds%3600) /60; Fov-i^a-t "the sedo^ds m-fco 

int secs = seconds%60; 你 im* 七 es, Sv\d sedo^ds. 

String time = String.format("%d:%02d : %02d", 
hours, minutes, secs); 

timeView • setText (time) ; ^ ^ ^ ^ ^ 七作七 
if (running) { 

seconds++; j-p is "tvuc ； .… 匕代你⑶七 

} the sedo^ds variable- 

handler .postDelayed (this , 1000) ; 4^ p 0 s*t CoAt a delay o( I scdoir>d- 


})； 


Let’s look at what happens when the code runs. 





this! 

平 

Make sure you update 
your activity code with 
our changes. 
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what happens 


What happens whew you ruw the app 



The user decides she wants to run the app. 

She clicks on the icon for the app on her device. 




The AndroidManifest.xml file for the app specifies which activity 
to use as the launch activity. 

An intent is constructed to start this activity using start Activity (intent). 


<^Cm|> I 

</>Cm|> I 

AndroidManif est.xml 




Android checks if theres already a process running for the app, 
and if not, creates a new process. 

It then creates a new activity object — in this case, for StopwatchActivity. 


Process 1 



VI) 

Android 
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The story continues 



The onCreate() method in the activity gets called. 

The method includes a call to se t Con tent View () ， specifying a layout, and then 
starts the stopwatch with runTimer (). 



runTimer() 



StopwatchActivity Layout 


When the onCreate() method finishes, the layout gets displayed on the 
device. 

The runTimer () method uses the seconds variable to determine what text to display 
in the text view，and uses the running variable to determine whether to increment 
the number of seconds. As running is initially false, the number of seconds isn’t 
incremented. 



tJieretare no o 

Dumb Questi9ns 


Why does Android run an app inside a separate 
process? 

For security and stability. It prevents one app accessing the 
data of another. It also means if one app crashes, it won’t take 
others down with it. 

Why have an onCreate () method? Why not just 
put that code inside a constructor? 

Android needs to set up the environment for the activity 
after it’s constructed. Once the environment is ready, Android 
calls onCreate () ■ That’s why code to set up the screen goes 
inside onCreate () instead of a constructor. 


Couldn’t I just write a loop in onCreate () to keep 
updating the timer? 

No, onCreate () needs to finish before the screen will 
appear. An endless loop would prevent that happening. 

runTimer () looks really complicated. Do I really 
need to do all this? 

It's a little complex, but whenever you need to schedule code 
like this, the code will look similar to runTimer (). 
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test drive 


Test drive the app 


When we run the app in the emulator, the app works great. We 
can start, stop, and reset the stopwatch without any problems at 
all — the app works just as you’d expect. 


These buttons v/ovk as youM TKc 

Siav-*t butto 灼 s*tav-is i\)t stofv/a*tdV>, i\\t 
S*tof bu*t*tor> s*tofs I 七， av>d Rcsc*t 

butto 灼 sc*ts s*fcop>w3*t^ii b^dk *to O. 


Put there's just owe problem. 


When we ran the app on a physical device, the app worked OK 
up until someone rotated the device. When the device was rotated, 
the stopwatch set itself back to 0. 



09:06 


丁 he s-topy/3*t^h v/3s bu 七 yts veset 

when 七 he device is vo-tated- 



In Androidville, it’s surprisingly common for apps to break when 
you rotate the device. Before we fix the problem, let’s take a closer 
look at what caused it. 
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What just happened? 


So why did the app break when the user rotated the screen? 
Let’s take a closer look at what really happened. 





The user starts the app, and clicks on the start button to set the 
stopwatch going. 

The runTimer () method starts incrementing the number of seconds displayed in 
the time—view text view using the seconds and running variables. 





seconds=12 


StopwatchActivity 


Device 


running=true 


The user rotates the device. 


Android sees that the screen orientation and screen size has changed, and it destroys 
the activity, including any variables used by the runTimer () method. 



StopwatchActivity is then re-created. 

The onCreate () method runs again, and the runTimer () method gets called. 
As the activity has been re-created, the seconds and running variables are set to 


their default values. 



Device 



•is because 七 he ad*t*iv"i*ty y/as 
dcs-tvoycd ar>d v-c-dvca*tcd 
⑶ dcvidc >was votaicd- 
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device configurations 


Rotating the screen changes the device configuration 


When Android runs your app and starts an activity, it takes 
into account the device configuration. By this we mean the 
configuration of the physical device (such as the screen size, screen 
orientation, and whether there’s a keyboard attached) and also 
configuration options specified by the user (such as the locale). 

Android needs to know what the device configuration is when it 
starts an activity because it can impact what resources are needed 
for the application. A different layout might need to be used if the 
device screen is landscape rather than portrait, for instance, and a 
different set of string values might need to be used if the locale is 
French. 


mal 
C java 
sires 

£] drawable 
t: drawable-hdpi 

> drawable-mcJpt 

> drawable-xh_i 

> drawable-xsthdpii 

► B layout 

► B menu 
T Bvalues 

<> dimens.xml 
。 strings.xml 
<> styles.xml 
▼ Cl values-fr 

[ I strings.xml 

► B values-wSZOdp 


A^dv-oid apps 

匕 orrtam multiple 

\rcsouVdc -files \y\ -the 
SYt /\rcs 

-Poldcv-. I-P ihc device 
locale is sci b> 
A^dv-oid will use ihc 
S'tv-'mjs.'X.irwl -file m -the 
values—p\r -foldcv-, -Pov 


AndroidManifj 


Tke device 

configuration incluctes 
options speciiiect 
ty tke user (suck 
as tke locale)，and 
options relating to tke 
pkysical device (suck 
as tke orientation anci 
screen size). A ckangfe 
to any ol tkese options 
results in tke activity 
teing ctestroyect ami 
re-created. 


When the device configuration changes, anything that displays a user 
interface needs to be updated to match the new configuration. If 
you rotate your device, Android spots that the screen orientation and 
screen size has changed, and classes this as a change to the device 
configuration. It destroys the current activity, and then re-creates it 
again so that resources appropriate to the new configuration get picked 
up. 
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From birth to death: the states of aw activity 

When Android creates and destroys an activity, the activity moves 
from being launched, to running, to being destroyed. 

The main state of an activity is when it’s running or active. An 
activity is running when it’s in the foreground of the screen, has the 
focus, and the user can interact with it. The activity spends most 
of its life in this state. An activity starts running after it has been 
launched, and at the end of its life, the activity is destroyed. 




tci lids 

Y\oi yet vurmi%. 


Activity running ) 切 s P e,ds 

rwos-t o( its li-fc hcvc. 


壯七 Ws fom 七 , youv 

Activity destroyed adiwrty u ， 

C%IS*U- 


An activity is running 
wken it’s in tke 
ioregfround oi tke screen. 


When an activity moves from being launched to being destroyed, 
it triggers key activity lifecycle methods: the onCreate () and 
onDestroy () methods. These are lifecycle methods that your 
activity inherits, and which you can override if necessary. 


The onCreate () method gets called immediately after your 
activity is launched. This method is where you do all your normal 
activity setup such as calling se t Con tent View () . You should 
always override this method. If you don’t override it, you won’t be 
able to tell Android what layout your activity should use. 


The onDestroy () method is the final call you get before the 
activity is destroyed. There are a number of situations in which 
an activity can get destroyed — for example, if it’s been told to 
finish, if the activity’s being re-created due to a change in device 
configuration, or if Android has decided to destroy the activity in 
order to save space. 


We’ll take a closer look at how these methods fit into the activity 
states on the next page. 


onCreateO gets called 
wken tke activity is iirst 
created, and it’s wkere 
you do your normal 
activity setup* 


onDestroyO gets callect 
just tefore your activity 
gets destroyed. 
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birth to death 


The activity lifecycle: from create to destroy 

Here’s an overview of the activity lifecycle from birth to death. As 
you’ll see later in the chapter, we’ve left out some of the details, 
but at this point we’re just focusing on the onCreate () and 
onDestroy () methods. 




destroyed 



The activity gets launched. 

The activity object is created and its constructor 
is run. 



The onCreate() method runs immediately 
after the activity is launched. 

The onCreate () method is where any 
initialization code should go, as this method 
always gets called after the activity has launched 
and before it starts running. 



An activity is running when it's visible in 
the foreground and the user can interact 
with it. 

This is where an activity spends most of its life. 



The onDestroyO method runs immediately 
before the activity is destroyed. 

The onDestroy () method enables you to 
perform any final clean up such as freeing up 
resources. 



After the onDestroyO method has run, 
the activity is destroyed. 

The activity ceases to exist. 


134 Chapter 4 












the activity lifecycle 


Your activity Inherits the lifecycle methods 

As you saw earlier in the book, your activity extends the android. app . Activity 
class. It’s this class that gives your activity access to the Android lifecycle methods: 



Context abstract class 

(android.content.Context) 

-to global mfowa 七 10 内 abou 七七 he appkatio 的 AHov/s 

addess *to a^lida'b'io^ vesouvdes, dlasscs, a^d appl*i^*t»oy>-lcvcl opcv-a*tior\s. 

ContextWrapper class 

(android.content.ContextWrapper) 

A fV"o^y implcrwC^"t 3 tioh -Pov* "the 

ContextThemeWrapper class 

(android.view.ContextThemeWrapper) 

The Coy>*tc%*tTV>cmclVv-affcv- alloy/s you *to mod'i-fy i\\t 七 heme 
-pv-om y/V>aVs *m Coir>ic%*tl/V\raffcv-. 

Activity class 

(android.app.Activity) 

The ddss implemerrts dc-Pault vcv-sio^s o( 

"tW li-Pcdydlc wtliods. I 七 also dc-Pmcs rwethods sudh 
as -f*md\/icY/By|d(|^ a^d sctCo^c^i\/icv/(l/icw). 


YourActivity class 

(com.hfad.foo) 

Mos*t o( *tKc bchaviov of youv ad*tiv'i*ty is 
by sufev*ddss me*thodU. All Y ou do is ovcv-v**idc 
*tlr>c mc*tiiods you v>ccd- 
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bypass with caution 


How do we deal with cowfiguratiow changes? 


As you saw, our app went wrong when the user rotated the screen. The activity 
was destroyed and re-created, which meant that local variables used by the 
activity were lost. So how do we get around this issue? How do we deal with 
device configuration changes such as a change to the screen orientation? 

There are two options: we can either tell Android to bypass restarting the activity, 
or we can save its current state so that the activity can re-create itself in the same 
state. Let’s look at these two options in more detail. 

bypass re-creating the activity 

The first option is to tell Android not to restart the activity if there’s been 
a configuration change. While we’re going to show you how to do this, 
bear in mind that it’s usually not the best option. This is because when 
Android re-creates the activity, it makes sure it uses the right resources for 
the new configuration. If you bypass this, you may have to write a bunch 
of extra code to deal with the new configuration yourself. 

You can tell Android not to re-create an activity due to a configuration 
change by adding a line to the activity element of the AndroidManifest. xml 
file like this: 


You’ll bypass built-in Android 
behavior that could cause 
problems. 



Only deal with 
configuration 
changes this 
way as a last 
resort. 


android: conf igChanges=’▼ conf igurat ion 一 change '▼ 

where conf iguration_change is the type of configuration change. 

In our case, we’d want to get Android to bypass a change to the screen 
orientation and screen size, so we’d need to add the following code to the 
AndroidManifest xml file: 




Stopwatch 


app/sre/main 

AndroidManifest.xml 


〈activity 

android:name="com.hfad.stopwatch.StopwatchActivity" 
android:label= M @string/app_name" 

android:configChanges="orientation|screenSize" > 


If Android encounters this type of configuration change, it makes a call 
to the onConfigurationChanged (Configuration) method 
instead of re-creating the activity: 


TiiC I *to bypass bo*th 

doy>-fi^uva*tior> TKis is be^duse 

、 mos 七 devices have a v-cttaia^ulav styttv\, 

so voiatmg devide bo*th 

OVlCir>*tol*tloy> dir>d 


public void onConfigurationChanged(Configuration config) { 


You can implement this method to react to the configuration 
change if you need to. 
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Or save the current state. 


The better way of dealing with configuration changes which you’ll use most 
often is to save the current state of the activity, and then reinstate it in the 
onCreate () method of the activity. 

To save the current state of the activity, you need to implement the 
onSavelnstanceState () method. The onSavelnstanceState () 
method gets called before the activity gets destroyed, which means you get 
an opportunity to save any values you want to retain before they get lost. 

The onSavelnstanceState () method takes one parameter, a 
Bundle. A Bundle allows you to gather together different types of data 
into a single object: 

public void onSavelnstanceState(Bundle savedlnstanceState) 





Activity rwninq 



The onCreate () method gets passed the Bundle as a 
parameter. This means that if you add the values of the running 
and seconds variables to the Bundle, the onCreate () 
method will be able to pick them up when the activity gets re¬ 
created. To do this, you use Bundle methods to add name/value 
pairs to the Bundle. These methods take the form: 

bundle.put* ( n name, value) 

where bundle is the name of the Bundle ， * is the type of value you 
want to save, and name and value are the name and value of the data. 
As an example, to add the seconds int value to the Bundle, you’d 
use: 


The o^Savcl 

rwcihod jets called 
bcW ohDcstvoyO. ^onSavelnstanceState() 

It Jives you a 

"to save youv- 

f d ； vi V s , onDestmyO 

bc+ov-c 七 he activity 

is dcs-t\roycd- 


Activity destroyed 


bundle.putlnt ('▼ seconds" , seconds); 


You can save multiple name/value pairs of data to the Bundle. 
Here’s our onSavelnstanceState () method in full: 

@Override 



Stopwatch 

app/sre/main 


public void onSavelnstanceState(Bundle savedlns tance State) 
savedlnstanceState.putlnt("seconds", seconds); 
savedlnstanceState.putBoolean("running", running) 


Now that we’ve saved our variable values to the Bundle, we can use 
them in our onCreate () method. 


Save values o( -the 
sctoY\ds av>d vurmms 
variables -bo *tKc Bundle- 


java 

LQ 

com. hfad. stopwatch 

山 “ f#7{1 

LJ 

Stopwatch 

Activity.java 


you are here ► 


137 























restore state 


thcw restore the state m owCrcateO 


As we said earlier, the onCreate () method takes one parameter, a 
Bundle. If the activity’s being created from scratch, this parameter 
will be null. If, however, the activity’s being re-created and there’s been 
a prior call to onSavelnstanceState (), the Bundle object 
used by onSavelnstanceState () will get passed to the activity: 


protected void onCreate(Bundle savedlnstanceState) 


You can get values from Bundle by using methods of the form 


^3 

Stopwatch 

KHl 

app/sre/main 
~ ^ lk 

L 」 


java 



com. hfad. stopwatch 


o 


Stopwatch 

Activity.java 


bundle.get*("name"); 


where bundle is the name of the Bundle, * is the type of value 
you want to get, and name is the name of the name/value pair you 
specified on the previous page. As an example, to get the seconds 
int value from the Bundle, you’d use: 

int seconds = bundle.getint("seconds"); 


Putting all of this together, here’s what our onCreate () method 
now looks like: 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity 一 stopwatch); 

if (savedlnstanceState != null) { 

seconds = savedlnstanceState.getlnt(’▼ seconds"); 
running = savedlnstanceState.getBoolean("running"); 

} 

runTimer(); 



Rci\ricvc the values of 
"the sedoKtds dhd 
vav-iabics -P\rom 七 he Bundle- 


辛 


So how does this work in practice? 



Da fMs! 

Make sure you update your 
onCreate() method and add the 
onSavelnstanceState() method. 
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What happens whew you ruw the app 


O 


❺ 


The user starts the app, and clicks on the start button to set the 
stopwatch going. 

The runTimer () method starts incrementing the number of seconds displayed in 
the time view text view. 





seconds=8 


StopwatchActivity 



running=true 


The user rotates the device. 

Android views this as a configuration change, and gets ready to destroy the activity. 
Before the activity is destroyed, onSavelnstanceState () gets called. The 
onSavelnstanceState () method saves the seconds and running values to a 
Bundle. 



seconds=8 


StopwatchActivity 


Device 



running=true 



bundle 

、 seconds〃=8 

'running^true 
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what happens 


The story continues 


O 


o 


o 


Android destroys the activity, and then re-creates it. 

The onCreate () method gets called, and the Bundle gets passed to it. 



bundle 

'running^true 


running=false 


The Bundle contains the values of the seconds and running variables as 
they were before the activity was destroyed. 

Code in the onCreate () method set the current variables to the values in the Bundle. 


Device 



、、 seconds〃=8 

''running^true 

The runTimer() method gets called, and the timer picks up where it 
left off. 

The stopwatch gets displayed on the device. 
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the activity lifecycle 


Test drive the app 


Make the changes to your activity code, then run the app. When 
you click on the Start button, the timer starts, and it continues 
when you rotate the device. 


09:29 


W\\tY\ vo*ta*tc ouv devide, 

七 he s*fcof>wa*Uii keeps oy\ 50*1^5. 



Why does Android want to 
re-create an activity just because I 
rotated the screen? 

The onCreate () method is 
normally used to set up the screen. If your 
code in onCreate () depended upon 
the screen configuration (for example, if 
you had different layouts for landscape 
and portrait) then you would want 
onCreate () to be called every time 
the configuration changed. Also, if the user 
changed the locale, you might want to re¬ 
create the Ul in the local language. 



Why doesn’t Android 
automatically store every instance 
variable automatically? Why do I have 
to write all of that code myself? 

You might not want every instance 
variable stored. For example, you might 
have a variable that stores the current 
screen width. You would want that 
variable to be recalculated the next time 
onCreate () is called. 


Is a Bundle some sort of Java 

map? 

No, but it’s designed to work like a 
j ava . util. Map. Bundles have 
additional abilities to maps, for example, 
Bundles have the ability to be sent 
between processes. That’s really useful, 
because it allows the Android OS to stay in 
touch with the state of an activity. 
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visible lifecycle 


There's more to aw activity's life thaw create awd destroy 


So far we’ve looked at the create and destroy parts of the activity 
life cycle, and you’ve seen how to deal with configuration changes such 
as a change in the screen orientation. But there are other events in an 
activity’s life that you might want to deal with to get the app to behave 
in the way you want. 


As an example, suppose the stopwatch is running and you get a phone i-f you Aoy\ v-cally 

call. Even though the stopwatch isn’t visible, it will continue running. *bo behave t € 

But what if you want the stopwatch to stop while it’s hidden, and tWis, a 七 00 

resume once the app is visible again? 3*t methods. 


Start stop, and restart 

Fortunately, it’s easy to handle actions that relate to an activity’s 
visibility if you use the right lifecycle methods. In addition to the 
onCreate () and onDestroy () methods, which deal with the 
overall lifecycle of the activity, there are other lifecycle methods 
that deal with an activity’s visibility. 


There are three key lifecycle methods that deal with when an 
activity becomes visible or invisible to the user. These methods 
are onStart () ， onStop (), and onRestart () . Just as with 
onCreate () and onDestroy () ， your activity inherits them 
from the Android Activity class. 


onStart () gets called when your activity becomes visible to the 
user. 

onStop () gets called when your activity has stopped being 
visible to the user. This might be because it’s completely hidden 
by another activity that’s appeared on top of it, or because the 
activity is going to be destroyed. If onStop () is called because 
the activity’s going to be destroyed, onSavelnstanceState () 
gets called before onStop (). 


An activity lias a state oi 
stopped il it’s completely 
kidden ty anotker activity 
and isn’t visible to tke 


user. Tke activity still 
exists in tke Lackgrounci 
and maintains all state 
information. 


onRestart () gets called after your activity has been made 
invisible, before it gets made visible again. 

We’ll take a closer look at how these fit in with the onCreate () 
and onDestroy () methods on the next page. 


142 


Chapter 4 


the activity lifecycle 


The activity lifecycle: the visible lifetime 


Let’s build on the lifecycle diagram you saw earlier in the chapter, this 
time including the onStart (), onStop () ， and onRestart () 
methods (the bits you need to focus on are in bold): 




The activity gets launched, and the 
onCreate() method runs. 

Any activity initialization code in the 
onCreate () method runs. At this point, the 
activity isn’t yet visible, as no call to onStart () 
has been made. 



o 


❺ 

o 

o 




If your device is 
extremely low on 
memory ， onStop() might 
not get called before the 
activity is destroyed. 


The onStart() method runs after the 
onCreate() method. It gets called when 
the activity is about to become visible. 

After the onStart () method has run, the user 
can see the activity on the screen. 

The onStopO method runs when the 
activity stops being visible to the user. 

After the onStop () method has run, the activity 
is no longer visible. 


If the activity becomes visible to the 
user again, the onRestart() method gets 
called followed by onStart(). 

The activity may go through this cycle many times 
if the activity repeatedly becomes invisible and 
visible again. 

Finally, the activity is destroyed. 

The onStop () method will usually get called 
before onDestroy () ， but it may get bypassed if 
the device is extremely low on memory. 
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stop and start 


Wc need to implement two more lifecycle methods 


There are two things we need to do to update our Stopwatch app. First, we 
need to implement the activity’s onStop () method so that the stopwatch 
stops running when the app isn’t visible. Once we’ve done that, we need 
to implement the onStart () method so that the stopwatch starts again 
when the app is visible. Let’s start with the onStop () method. 

Implement owStopO to stop the timer 

You override the onStop () method in the Android Activity class by 
adding the following method to your activity: 

@Override 

protected void onStop() { 

super.onStop(); 


□ 

Stopwatch 

1 - [jj 

app/sre/main 

L rn 



com. hfad. stopwatch 

I F 二 ] 

a 


Stopwatch 

Activity.java 


Whenever you override one of the Android lifecycle methods, it’s 
important that you first call up the onStop () method in the superclass 
using: 


super.onStop(); 


There are a couple of reasons for this. First, you need to make sure that the 
activity gets to perform all of the actions in the superclass lifecycle method. 
Second, Android will never forgive you if you bypass this step — it will 
generate an exception. 

We need to get the stopwatch to stop when the onStop () method is 
called. To do this, we need to set the value of the running boolean to 
false. Here’s the complete method: 

@Override 

protected void onStop() { 
super.onStop(); 
running = false; 


Wken you override 
an activity 
lilecycle metkoct, 


you need to call tke 
superclass metkoct. 
II you cton’t ， you’ll 


get an exception. 


So now the stopwatch stops when the activity is no longer visible. The next 
thing we need to do is get the stopwatch to start again when the activity 
becomes visible. 
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Cf c ^rpen your pencil 


Now it’s your turn. Change the activity code so that if the 
stopwatch was running before onStop () was called, it starts 
running again when the activity regains the focus. 


public class StopwatchActivity extends Activity { 
private int seconds = 0; 
private boolean running; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—stopwatch); 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState • getlnt (’'seconds ，'）； 
running = savedlnstanceState • getBoolean ( "running '，）； 

} 

runTimerO; (Wsi fart Codt. 

} YoiaII bo 

methods sli^-tly -too. 

QOverride 

public void onSavelnstanceState(Bundle savedlnstanceState) { 
savedlnstanceState.putlnt("seconds ", seconds); 
savedlnstanceState•putBoolean("running ”， running); 
savedlnstanceState•putBoolean( n wasRunning n , wasRunning); 


@Override 

protected void onStop() { 

super.onStop(); 
running = false; 
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sharpen solution 


O^Sterpen your pencil 


Now it’s your turn. Change the activity code so that if the 
stopwatch was running before onStop () was called, it starts 
running again when the activity regains the focus. 


public class StopwatchActivity extends Activity { 


private int seconds = 0; 
private boolean running; 

pviva*tc boolean ♦ - 〆 


QOverride 


Wis Bddcd 3 new vaviablc ； -fco v*cdov*d v/hcthcv* 

■Bie s-topv/a-t£.h was \rurmm 3 bc-Po\rc o^S^fcopO method 
v/ds tsWcd so "that v/c know whc*thcv* -fco sc*t i"t v-urm’mj 
agam when 七 he a^iivi-ty becomes visible 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_stopwatch); 


if (savedlnstanceState != null) { 

seconds = savedlnstanceState • getlnt ('’seconds ”）； 
running = savedlnstanceState • getBoolean ("running ，'）； 


二 savedIhS-tahdcS-ta-tc^C-tBoolcahO'y/asRuhhm^O ； 

I/Vcll rtsbort ihc sia*tc o-f i\\t v/asRuymnr^ 
variable \( i\\c attivi-ty is rt-trcaitA- 


runTimer(); 


@Override 

public void onSavelnstanceState(Bundle savedlnstanceState) { 


savedlnstanceState .putlnt (’'seconds", seconds); 
savedlnstanceState • putBoolean ( "running’ ，， running); 

saved|r\s*tahdcS*ta*tc pu*tBoolcar\( u y/asRuhh*m^, y/asRurmir^); ^ — 


Save -the staic o( 七 he 

vd\ridble- 


@Override 

protected void onStop() { 

super . onStop () ; Rcdovd v/hc*thcv- s*fcof>wa*tdii v/ 3 s \rurmm 3 

y/asRurmm 3 二 rurm.n^ ▲ 的七 he o^° wthod v/as dallcd- 

running = false; 


^Ovcrvidc 


p\ro*tcd*tcd void ohS*ta 矿七 0 { 
supc\roj^S*t3\rtO ； 

i-f { 

二 *brucj 


(mplcrwc^-t "the onS*ta\rtO 
rweihod. If ihc s-topwatdh Y/as 
\rujrmm 少 sci ii vwrmmg a^a'm. 


} 
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The updated StopwatchActivity code 


We updated our activity code so that if the stopwatch was running 
before it lost the focus, it starts running again when it gets the focus 
back. Make the changes to your code: 


□ 

Stopwatch 

L a 


public class StopwatchActivity extends Activity { 

private int seconds = 0; A v-cdovds 

private boolean running; whe 七 he\r ihc s-topwa-Uh y/as bc-fo 

private boolean wasRunning; 七 ohS-fcopO me 七 hod was cMtd so -that 

v/e know wheihev- to sci i*t ruKmmg ajairt 
@ Override 七 he a 匕 "tiv/.rty bcdoyncs visible 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 


app/sre/main 

L a 

v-c java 



com. hfad. stopwatch 



Stopwatch 

Activity.java 


setContentView(R.layout.activity_stopwatch); 


if (savedlnstanceState != null) { 


seconds = savedlnstanceState • getlnt (’'seconds ，'）； 
running = savedlnstanceState • getBoolean ( "running '，）； 

wasRunning = savedlnstanceState.getBoolean("wasRunning"); 


runTimer(); 


Rcsiore ihc siaic o\ i\\t y/asRu^m^ 
vav-iablc i-f *tKc activity is vc-tvca*tcd. 


@Override 

public void onSavelnstanceState(Bundle savedlnstanceState) { 
savedlnstanceState .putlnt ("seconds’ ，， seconds); 
savedlnstanceState•putBoolean("running ”， running); 

savedlnstanceState.putBoolean("wasRunning", wasRunning); 


Save "the s-ta-tc o( 七 he 
vdvidble- 


@Override 

protected void onStop() { 

super • onS top (> ; RcCo^rd y/V>C*thcv s{p^ait\\ >w3s iruymnr^ 

wasRunning = running; ^ 七 oy>£*tofO rweihod >m3s dallcd- 

running = false; 


@Override 


protected void onStart() { 


super.onStart(); 
if (wasRunning) { 
running = true; 




-the O^Stav-t0 

mcihod. 1 ( 七 he s-topwaidh v/as 
normm 少 sci ii ruKmmg 
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what happens 


What happens whew you ruw the app 



The user starts the app, and clicks the Start button to set the stopwatch going. 

The runTimer () method starts incrementing the number of seconds displayed in the time—view 
text view. 



Device 




The user navigates to the device home screen so the Stopwatch app is no longer 
visible. 


The onStop () method gets called, wasRunning is set to true, running is set to false, and the 
number of seconds stops incrementing. 


The adiivi-ty still 
Crists -though 
i*t’s ⑽七 visible- 



Device 




seconds=16 


is sc*t 

I ~~ *to -false *m *thc 


Stopwatch 

Activity 


runn^false 為 。 d . 



wasRunning=true 



The user navigates back to the Stopwatch app. 

The onStart () method gets called, running is set to true, and the number of seconds starts 
incrementing again. 



Device 



\ruhhihj is set 
h> t\ruc ih the 
OhSta\rt0 method. 
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wasRunning=false 










the activity lifecycle 


Test drive the app 

Save the changes to your activity code, then run the app. When 
you click on the Start button the timer starts, it stops when the 
app is no longer visible, and it starts again when the app becomes 
visible again. 


09:38 



there ^ are no o 

Dumb Questions 


Could we have used the onRestart () method 
instead? 

onRestart () is used when you only want code to 
run when an app becomes visible after having previously been 
invisible. It doesn’t run when the activity becomes visible for the 
first time. In our case, we wanted the app to still work when we 
rotated the device. 


Why should that make a difference? 


When you rotate the device, the activity is destroyed 
and a new one is created in its place. If we’d put code in the 
onRestart () method instead, it wouldn’t have run when the 
activity was re-created. The onStart () method gets called in 
both situations. 
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foreground lifecycle 


Put what if aw app is only partially visible? 

So far you’ve seen what happens when an activity gets created and 
destroyed, and you’ve also seen what happens when an activity 
becomes visible, and when it becomes invisible. But there’s one more 
situation we need to consider: when an activity’s visible but doesn’t 
have the focus. 

When an activity is visible but doesn’t have the focus, the activity is 
paused. This can happen if another activity appears on top of your 
activity that isn’t full-size or that’s transparent. The activity on top has 
the focus, but the one underneath is still visible and is therefore paused. 



The s-fcopy/aidh 

adiivi-ty is still 
^^ visible, bu 七 
•rt’s partially 
obs£.u\rcd dnd ho 


lo^gcv- 

-rodus. 


has 七 he 


This is air> 
activity -f I 






oy\ *tof o( 七 he 
s*topy/a*t^h- 


An activity lias a 
state ol paused ii it’s 
lost tke locus tut is 
still visitle to tke 


user. Tke activity 
is still alive and 
maintains all its state 
information. 


There are two lifecycle methods that deal with when the activity 
is paused and when it becomes active again: onPause () and 
onResume () . onPause () gets called when your activity is visible 
but another activity has the focus. onResume () is called immediately 
before your activity is about to start interacting with the user. If you 
need your app to react in some way when your activity is paused, you 
need to implement these methods. 


You’ll see on the next page how these methods fit in with the rest of the 
lifecycle methods you’ve seen so far. 
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the activity lifecycle 


The activity lifecycle: the foreground lifetime 

Let’s build on the lifecycle diagram you saw earlier in the chapter, this 
time including the onResume () and onPause () methods (the new 
bits are in bold): 




o 


Activity destroyed 



The activity gets launched, and the 
onCreate() and onStart() methods run. 

At this point, the activity is visible, but it doesn’t 
have the focus. 



The onResume() method runs after the 
onStart() method. It gets called when 
the activity is about to move into the 
foreground. 

After the onResume () method has run, the 
activity has the focus and the user can interact 
with it. 




The onPause() method runs when the 
activity stops being in the foreground. 

After the onPause () method has run, the 
activity is still visible but doesn’t have the focus. 


If the activity moves into the 
foreground again, the onResume() 
method gets called. 

The activity may go through this cycle many times 
if the activity repeatedly loses and regains the 
focus. 





If the activity stops being visible to the 
user, the onStopO method gets called. 

After the onStop () method has run, the activity 
is no longer visible. 


If the activity becomes visible to the 
user again, the onRestart() method 
gets called, followed by onStart() and 
onResume(). 

The activity may go through this cycle many times. 

Finally, the activity is destroyed. 

As the activity moves from running to destroyed, 
the onPause () method gets called before the 
activity is destroyed. The onStop () method 
usually gets called too. 
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rotation 



Earlier on you talked about how 
the activity is destroyed and a new one is 
created when the user rotates the device. 
What happens if the activity is paused when 
the device is rotated? Does the activity go 
through the same lifecycle methods? 



That’s a great question, so let’s look at this in more 
detail before getting back to the Stopwatch app. 


The original activity goes through all its lifecycle methods, from 
onCreate () to onDestroy () . A new activity is created when the 
original is destroyed. As this new activity isn’t in the foreground, only 
the onCreate () and onStart () lifecycle methods get called: 


Original Activity 



onCreate 。 

A 丄 

U onStart() 

i 

onResume() 



Activity running 



❺ onPause() 



The user launches the activity. 

The activity lifecycle methods onCreate (), 
onStart () ， and onResume () get called. 



Another activity appears in front of 
it. 

The activity onPause () method gets called. 



The user rotates the device. 

Android sees this as a configuration change. 
The onStop () and onDestroy() 
methods get called, and Android destroys the 
activity. A new activity is created in its place. 



The activity is visible but not in the 
foreground. 

TheonCreate() andonStart() 
methods get called. As the activity is 
only visible and doesn’t have the focus, 


onStop() 



on Destroy () 


onResume () isn’t called. 

Replacement Activity 
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the activity lifecycle 



O 




I see, the replacement activity doesn’t reach 
a state of ''running" because ifs not in the 
foreground. But what if you navigate away from 
the activity completely so ifs not even visible? 
If the activity’s stopped, do onResume() and 
onPause() get called before onStopQ? 


Activities can go 
straight from onStart() 
to onStop() and 
bypass onPause() and 
onResume(). 

If you have an activity that’s 
visible, but never in the 
foreground and never has the 
focus, the onPause () and 
onResume () methods never 
get called. 

The onResume () method gets 
called when the activity appears 
in the foreground and has the 
focus. If the activity is only 
visible behind other activities, 
the onResume () method 
doesn’t get called. 

Similarly, the onPause () 
method gets called when the 
activity is no longer in the 
foreground. If the activity is 
never in the foreground, this 
method won’t get called. 

(attiVrty s ov Atbro^td bcW ^ 
t m -fovcyour\d) 七 (） 

is Jpollov/cd by i\\t o^S*topO method. 
wRcsumcO ar\d or\PauscO avc bypassed- 



onCreate() 


onStart() 


> onResume() 



Activity running 



onPause() 


> onStop() 


on Destroy () 


Activity destroyed 


onRestart() 
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replace methods 


Stop the stopwatch if the activity's paused 


Let’s get back to the Stopwatch app. 


So far we’ve made the stopwatch stop if the Stopwatch app isn’t 
visible, and made it start again when the app becomes visible 
again. In addition to this, let’s get the stopwatch to stop if the 
activity is paused, and start again when the activity is resumed. 
So which lifecycle methods do we need to implement? 


The easy answer is that we need to use the onPause () 
and onResume () methods, but we can take this one step 
further. We’ll use these methods to replace the calls 
to onStop () and onStart () that we’ve already 
implemented. If you look again at the lifecycle diagram, 
calls are made to onPause () and onResume () in addition to 
onStop () and onStart () whenever an activity is stopped 
and started. We’ll use the same methods for both situations as 
we want the app to behave in the same way. 


onStart() 



onRestart() 


Here’s our version of the onPause () method: 

@Override 

protected void onPause() { 

super.onPause(); 
wasRunning = running; 
running = false; 

} 

And here’s the onResume () method: 


@Override 

protected void onResume() { 

super.onResume(); 
if (wasRunning) { 
running = true; 


So let’s see what happens when we run the app. 


onStop() 


u 

Stopwatch 


L d 

app/sre/main 

'^3 


java 


com. hfad. stopwatch 


<u» 

- A 


Stopwatch 

Activity.java 



Replace the onStop() and 
onStart() methods in your 
code with the onPause() and 
onResume() methods shown here. 
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the activity lifecycle 


What happens whew you ruw the app 



The user starts the app, and clicks on the start button to set the stopwatch going. 

The runTimer () method starts incrementing the number of seconds displayed in the time—view 
text view. 



Device 




Another activity appears in the foreground, leaving Stopwatch Activity partially visible. 

The onPause () method gets called, wasRunning is set to true, running is set to false, and the 
number of seconds stops incrementing. 


The a^tiv/’rty is 
as rt’s visible bu 七 ⑽ 七 
m ihc -fov-cgv-ou^d- 




seconds=15 




Stopwatch 

Activity 


is sc*t 
*to -false *m 


running=false oy> p ausc0 



wasRunning=true 



When Stopwatch Activity returns to the foreground, the onResume() method gets 
called, running is set to true, and the number of seconds starts incrementing 
again. 



Device 



seconds=15 




Stopwatch 

Activity 


runnmg=true 



wasRunning=false 


V-uhh'mg is set 
"to t\ruc ih the 
ohRcsurwcO method. 
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test drive 

r _ K 

—— 

Test drive the app 

Save the changes to your activity code, then run the app. When 
you click on the Start button, the timer starts; it stops when the 
app is partially obscured by another activity, and it starts again 
when the app is back in the foreground. 


09:52 


0:00:41 


START 


STOP 


RESET 


iVe stav-ied ouv- s-topwa-Uh. 

I 七 paused when 七 he adtivi-ty 
was pav-tially obs^uv-cd- 



0:03:01 



09:55 


START 


STOP 


RESET 


0:03:26 


Walk dog 

Any.do Reminder 

© 

© 

0 

DISMISS 

SNOOZE 

DONE! 



n 


START 


STOP 


RESET 


The s-tofy/a-Uh stav-*tcd aym 
v/V>cy> *tV>c ad*t*iv*i*ty batk 
*m*to 七 he -fov-cyou^d- 


theretqre no ^ 

Dumb Questions 


^^,-As some of the lifecycle methods aren’t always called, it 
sounds like this can lead to some flaky apps. Is that right? 

In certain circumstances, Android may choose not to call 
methods like onStop () and onPause (). These methods 
usually contain code to clean up the app. 


onCreate () and onStart () will always be called at the 
correct time, and this means that your app can also make sure it 
begins in the right shape. That’s far more important. 

The key thing is that you really get which lifecycle methods get 
called under what circumstances. 
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the activity lifecycle 


The complete activity code 

Here’s the full StopwatchActivity.java code for the finished app: 


package com.hfad.stopwatch; 


import 

import 

import 

import 

import 


android.os.Bundle; 
android.os.Handler; 
android.app.Activity; 
android.view.View; 
android.widget.TextView; 



Stopwatch 



app/sre/main 

L n 



public class StopwatchActivity extends Activity { 

/ /Number of seconds displayed on the stopwatch. 
private int seconds = 0 
//Is the stopwatch running? 
private boolean running 
private boolean wasRunning 


Use sedoi^ds ； vuyrnm 》 3 v>d *to vedovd 

七 scdoy>ds passed ， 七 

: is vuirmn^ ， 扣 dl y/V>c*thcv* S'topY/S't^^ 

mg； ^ Y,as \ru^m5 before *thc adtivity y/as paused- 


com. hfad. stopwatch 

山 “ f»T {1 

O 

Stopwatch 
Activity.java 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 


super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—stopwatch); 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState • getlnt (’'seconds"). 
running = savedlnstanceState • getBoolean ( "running ’，）； 
wasRunning = savedlnstanceState•getBoolean( n wasRunning n ) 


心七 -the previous siaic o( 七 he 
广 i-p 七 he adtivi-ty^s 

dcs-t\roycd \rc-dv-caicd- 


runTimer(); 


QOverride l-P -tKc adtiv*i*tys paused, s*bop -the s*tof\wa*tdh. 

protected void onPause () { 

super.onPause (); 
wasRunning 二 running; 
running = false; 


QOverride 

protected void onResume() 
super.onResume(); 
if (wasRunning) { 
running = true; 


^ 1^ the activity's v-esumed, siari 
the ol^dih i-p i-t wds 

\ruhhihg pvcviously. 


The adiivi-ty 

Code 匕 o>vtmues 

ovc\r 七 he page. 
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StopwatchActivity code 


The activity code (cowtiwued) 

QOverride 


Save i\^t siait st>pv/a*U^ 

^ i-t's about *to be des-tvoyed- 


public void onSavelnstanceState(Bundle savedlnstanceState) { 


savedlnstanceState .putlnt (’'seconds ， ' ， seconds); 
savedlnstanceState • putBoolean (▼ ， running' ，， running); 
savedlnstanceState•putBoolean( n wasRunning n , wasRunning); 


//Start the stopwatch running when the Start button is clicked. 
public void onClickStart(View view) { 
running = true; 々 


This yts dalled y/he 灼七 S*tav**t bu*t*to^ is dlidked. 


//Stop the stopwatch running when the Stop button is clicked. 
public void onClickStop(View view) 
running = false; 

} 


This jets tailed wh ⑶七 he S-top bu-t-to^ is didked. 


This jets called whe 竹七 he Reset burtton is didked. 


/ /Reset the stopwatch when the Reset button is clicked. 
public void onClickReset(View view) { f 
running = false; 

seconds = 0; The v-ur^TimCV-O method uses a W^A\tr *to *md\rCmcy>*t 

七 he sedoy>ds av\A ufdaic viw. 




//Sets the number of seconds on the timer. 
private void runTimer() { 

final TextView timeView = (TextView)findViewByld(R•id•time_view); 
final Handler handler = new Handler(); 
handler.post(new Runnable () { 

QOverride 

public void run () { 

int hours = seconds/3600; 
int minutes = (seconds%3600) / 60; 
int secs = seconds%60; 

String time = String.format( n %d:%02d:%02d" f 
hours, minutes, secs); 
timeView.setText(time); 
if (running) { 
seconds++; 

} 

handler.postDelayed(this f 1000); 


□ 

Stopwatch 

app/sre/main 


java 


com. hfad. stopwatch 

Stopwatch 

Activity.java 


})； 
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the activity lifecycle 


BEfk _fy 

On the right youll see some activity 
code. Your joL is to play like you’re 
the activity and say Mfech 

code will run in each 
of the situations below. 
Wve labeled the code 
we want you to consider. 
Wve done the first one to 
start you off • 

User starts the activity and starts using it. 

Code 6\ f D. The ad*tivi*ty is treated, 

i*t’s made visible, i*t receives *thc -fodus. 

User starts the activity，starts using it, 
then switches to another app. 



class MyActivity extends Activity! 

protected void onCreate( 

Bundle savedlnstanceState) 
/ /Run code A 


o 


protected void onPause() 
/ /Run code B 


o 


protected void onRestart() 
/ /Run code C 


o 


protected void onResume() 
/ /Run code D 


o 




TWis one’s *to—. 


User starts the activity，starts using it, 
rotates the device, switches to another 
app, then goes back to the activity. 


protected void onStop () 
/ /Run code E 


❾ 


protected void onRecreate() 
/ /Run code F 


o 


protected void onStart() 
/ /Run code G 


o 


protected void onDestroy() 
/ /Run code H 


© 
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BE flie- 

On the ri^it, you’ll see some activity 
code. Your job is to play like you’re 
the activity and say y^iich 

code will run in each 
of the situations below. 
Wve labeled the code 
we want you to consider. 
Wve done the first one to 
start you off. 



User starts the activity and starts using it. 

Code sc^er\*b 6\ f D. The ad*tivi*ty is treated, 
i-t^s made visible, i*t v-edeives *thc -fodus. 

User starts the activity, starts using it, 
then switches to another app. 

Code sc^ch*b ^i) V) B) E. The ad*tivi*ty is 
d\rea*ted, i*t’s r^ade visible ar\d receives -the 
-fodus. W/hch *the usev sv/rtdhes *(x> aho*thcv* app, 
i 七 loses *thc -fodus dr\d is y\o lo^ev- visible b> *the 
user 

User starts the activity, starts using it, 
rotates the device, switches to another 
app, then goes back to the activity. 

Code 6\ f V, B, E, W, K ^ V, B, B, 

C, 6\) D. First, -the ad*tivi*ty is d\rca*ted, made 
visible, ar\d rcdcivcs *thc -fodus. W\\tY\ *thc devide 
is \ro*ta*tcd, *thc ad*tivi*ty loses "the -fodus, s*bops 
bc'mg visible, a^d is ddoyedl. I*t’s *ther\ d\rca*tcd 
a^a'm, made visible, a^d receives -the -fodus. I/Vhcr\ 

■the user swi*tdhes *bo aho*the\r app a^d badk 

*thc ad*tivi*ty loses *thc -fodus, loses visibili*ty) 
bcdor^cs visible a^d rcaaihs *thc -fodus. 


class MyActivity extends Activity! 


protected void onCreate( 

Bundle savedlnstanceState) 
/ /Run code A 


o 


protected void onPause() 
/ /Run code B 


o 


protected void onRestart() 
/ /Run code C 


o 


protected void onResume() 
/ /Run code D 


o 


protected void onStop () 
/ /Run code E 


❾ 


Thcvc^s Y\0 1'i-fcdydlc 

method ddllcd 
dC. oy>Rcdvca*tcO. 




protected void onRecreate() 
/ /Run code F 


o 


protected void onStart() 
/ /Run code G 


o 


protected void onDestroy() 
/ /Run code H 


© 
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Your handy guide to the lifecycle methods 


Method 

When it’s called 

Next method 

onCreate () 

When the activity is first created. Use it for normal 
static setup, such as creating views. It also gives 
you a Bundle giving the previously saved state 
of the activity. 

onStart () 

onRestart O 

When your activity has been stopped just before 
it gets started again. 

onStart() 

onStart O 

When your activity is becoming visible. It’s 
followed by onResume ( ) if the activity comes 
into the foreground, or onStop ( ) if the activity 
is made invisible. 

onResume ( ) or 
onStop () 

onResume Q 

When your activity is in the foreground. 

onPause ( ) 

onPause O 

When your activity is no longer in the foreground 
because another activity is resuming. The next 
activity isn't resumed until this method finishes, 
so any code in this method needs to be quick. It’s 
followed by onResume () if the activity returns 
to the foreground, or onStop () if it becomes 
invisible. 

onResume () or 
onStop () 

onStop O 

When the activity is no longer visible. This can be 
because another activity is covering it, or because 
the activity’s being destroyed. It’s followed by 
onRestart () if the activity becomes visible 
again, or onDestroy () if the activity is going 
to be destroyed. 

onRestart () or 
onDestroy () 

onDestroyQ 

When your activity is about to be destroyed or 
because the activity is finishing. 

None 
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Your Android Toolbox 

You’ve got Chapter 4 under 
your belt and now you’ve 
added the activity lifecycle to 
your toolbox. 


You c^y\ download 
-full code ^OV 

Wt 七尸 : //Uy^avU^/ 

HcadPtv-stA^dvoid. 






BULLET POINTS 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


Each app runs in its own process by default. 

Only the main thread can update the user 
interface. 


■ Use a Handler to schedule code, or post code 
to a different thread. 


A device configuration change results in the 
activity being destroyed and re-created. 

Your activity inherits the lifecycle methods from the 
Android Activity class. If you override any of 
these methods, you need to call up to the method 
in the superclass. 

onSavelnstanceState(Bundle) 

enables your activity to save its state before the 
activity gets destroyed. You can use the Bundle 
to restore state in onCreate (). 

You add values to a Bundle using 
bundle•put*( n name n , value). 

You retrieve values from the bundle using 

bundle.get*("name"). 

onCreate () and onDestroy (), deal with 
the birth and death of the activity. 

onRestart ( ),onStart( ) and 
onstop () deal with the visibility of the activity. 

onResume () and onPause ( ) deal with 
when the activity gains and loses the focus. 




on Destroy () 


Activity destroyed 
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5 the user interface 



Let’s face it, you need to know how to create great layouts. 

If you’re building apps you want people to use, you need to make sure they look just the 
way you want. So far we’ve only scratched the surface when it comes to creating layouts, 
so it’s time to look a little deeper. We’ll introduce you to more types of layout you can 
use, and we’ll also take you on a tour of the main GUI components and how you use 
them. By the end of the chapter, you’ll see that even though they all look a little different, 
all layouts and GUI components have more in common than you might think. 


this is a new chapter 
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the ui 


Your user interface is made up of 
layouts and frUl components 

As you already know，a layout defines what a screen looks like, and 
you define it using XML. Layouts usually contain GUI components 
such as buttons and text fields. Your user interacts with these to make 
your app do something. 

All the apps you’ve seen in the book so far have used relative layouts, 
but there are other types of layout you can use as well to get your app 
to look exactly how you want. 



In this chapter, we’re going to introduce some of the other 
layouts you’ll want to use in your apps, and also more of the GUI 
components you can use to make your app more interactive. Let’s 
start with the layouts. 
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the user interface 


Three key layouts: 
relative, linear, and grid 


Layouts come in several flavors, and each one has their own policy to 
follow when deciding where to position the views it contains. Here are 
three of the key ones. Don’t worry about the details for now, over the 
next few pages we’re going to take you through each one. 


RelativeLayout 

A relative layout displays its views in relative 
positions. You define the position of each view 
relative to other views in the layout, or relative to 
its parent layout. As an example, you can choose to 
position a text view relative to the top of the parent 
layout, a spinner underneath the text view, and a 
button relative to the bottom of the parent layout. 


Liwearlayout 

A linear layout displays views next to each other 
either vertically or horizontally. If it’s vertically, 
the views are displayed in a single column. If it’s 
horizontally, the views are displayed in a single row. 



\/*ic>ms ddr> be flawed 
vclativc *bo 

layout-. 


… o\r "to o-thc\r views. 



\/*IC>mS av-C positioned 

-to eadK ciihcv- 

vcvtidally ov hovizo^-tally. 

• V 


^ridlayout 

A grid layout divides the screen into a grid of rows, 
columns, and cells. You specify how many columns 
your layout should have, where you want your views 
to appear, and how many rows or columns they 
should span. 


The is divided 

_ into \rov/s a^d dolur»ms, 
and you spcdi-Py whidh 
^cll oy dells eadh view 
should be displayed m. 
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relative layout 

RdativeLayout displays views 
m relative positions 

As you already know，a relative layout allows you to position views 
relative to the parent layout, or relative to other views in the layout. 

You define a relative layout using the <RelativeLayout> 
element like this: 



RelativeLayout 

LinearLayout 

GridLayout 


This -tells f[Y\Aro\A 
youVc us'm^ 3 

vela 七 We layout- 


<RelativeLayout xmlns : android: n http://schemas.android.com/apk/res/android" 
android : layout_width= M match_^parentThe layou 七一 a 灼 d spcdi-fy 

android: layout_height= n match_parent"^ Vi ^^ S 2 * € Y ou layout be. 

• • • 〉 ^Thcv-c r^ay be o-thev- atbribu 七 es -too. 


</RelativeLayout> 


The xmlns : android attribute is used to specify the Android 
namespace, and you must always set it to "http : //schemas . 
android.com/apk/res/android". 


You MUST set the layout width and height 

The android : layout—width and 
android : layout—height attributes specify how wide 
and high you want the layout to be. These attributes 
are mandatory for all types of layout and view. 

You can set android : layout—width and 
android : layout—height to "match—parent 
n wrap_content n ora specific size such as lOdp - 10 
density-independent pixels. n wrap_content n means 
that you want the layout to be just big enough to hold all of 
the views inside it, and n match_parent n means that you 
want the layout to be as big as its parent — in this case, as 
big as the device screen minus any padding. You will usually 
set the layout width and height to n match_parent f, . 

You may sometimes see android : layout—width and 
android : layout—height set to n f ill_parent 
"f ill—parent n was used in older versions of Android, 
and it’s now replaced by ’ ▼match—parent" f ill_ 
parent" is deprecated. 


Bits - 

What are density-independent pixels? 

Some devices create very sharp images 
by using very tiny pixels. Other devices 
are cheaper to produce because they 
have fewer, larger pixels. You use 
density-independent pixels (dp) to 
avoid creating interfaces that are overly 
small on some devices, and overly large 
on others. A measurement in density- 
independent pixels is roughly the same 
size across all devices. 
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Adding padding 


If you want there to be a bit of space around the edge of the layout, 
you can set padding attributes. These attributes tell Android how 
much padding you want between each of the layout's sides and its 
parent. Here’s how you would tell Android you want to add padding 
of 16dp around all edges of the layout: 


<RelativeLayout 

android : paddingBottom="16dp 
android : paddingLeft="16dp" 
android : paddingRight="16dp 
android : paddingTop= M 16dp M > 



Add padd'mj I 厶却 . 


the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


paddm^lof 




</RelativeLayout> 

The android : padding* attributes are optional, and you can use 
them with any layout or view. 

In the above example, we’ve hardcoded the padding and set it 
to 16dp. An alternative approach is to specify the padding in a 
dimension resource file instead. Using a dimension resource file 
makes it easier to maintain the padding of all the layouts in your app. 

You use a dimension resource file by setting the padding attributes in 
your layout file to the name of a dimension resource like this: 

<RelativeLayout ... 

android : paddingLeft= M @dimen/activity_horizontal_margin 
android : paddingRight= n @dimen/activity 一 horizontal 一 margin 
android : paddingTop= n @dimen/activity 一 vertical— margin" 
android : paddingBottom= n @dimen/activity— vertical— margin ，，〉 

Android then looks up the values of the attributes at runtime in the 
dimension resource file. This file is located in the app/src/main/res/ 
values folder, and it’s usually called dimens.xml\ 





paddmgRiglvt 




The 

3v*C set 把七 Wi 七 Y— 

hov^zjorrtal 一州狄 

TKc paddih^Top av\d 
paddmgBot-tom atlv-ibu-tcs 
sci -to ^di^Ch/adtivity__ 

vc\rtidal_rwav-gih. 一 


<resources> 

<dimen name=' 
<dimen name=' 
</resources> 


ac tivity_hori zontal—margin ▼▼ >16dp</dimen> 
activity vertical margin n >16dp</dimen 


T\\t layout looks uf 
f>dddm5 values 

d\^tv\ \rCSou\rtcs. 


When you create a new Android Studio project and add an activity to 
it, the IDE will usually create this for you. 
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relative to parent 



Positioning views relative to the parewt layout 


RelativeLayout 

LinearLayout 

GridLayout 


When you use a relative layout, you need to tell Android where you want 
its views to appear relative to other views in the layout, or to its parent. A 
view’s parent is the layout that contains the view. 

If you want a view to always appear in a particular position on the screen, 
irrespective of the screen size or orientation, you need to position the view 
relative to its parent. As an example, here’s how you’d make sure a button 
always appears in the top-right corner of the layout: 


〈RelativeLayout ... > 
I <Button 


Ti^c layout 

biA*bto 〜 so 
layout is 七 he 
button’s 


android : layout 一 width= n wrap_content n 
android : layout 一 height= n wrap_content n 
android : text= M @string/click_me" 

android:layout—alignParentTop= n true n 
android:layout—alignParentRight="true n 


</RelativeLayout> 


The lines of code 


l3youi_al 

一 V 


The 

layou-t 


/> 


The dhild view. 



layou 七一 al 咖 PaveirrtRi^> 七 


android : layout_alignParentTop="true" 
android : layout_alignParentRight= M true" 

mean that the top edge of the button is aligned to the top edge of the 
layout, and the right edge of the button is aligned to the right edge of the 
layout. This will be the case no matter what the screen size or orientation 
of your device: 



12:14 


CLICK ME 



TKc butter appeav-s m -tKc 
•top - i-f 

ovicr\*ta*t'ior\ is po\rt\rai*t 
ov ld^ds^df>e, i\rvcspcd*tivc of 


sizjC- 
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Attributes for positioning views 
relative to the parent layout 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


Here are some of the most common attributes for positioning 
views relative to their parent layout. Add the attribute you want 
to the view you’re positioning, then set its value to "true’ ▼: 

android : attribute= M true" 


Attribute 

android: 

layout.alignParentBottom 


android: 

layout.alignParentLeft 


What it does 

Aligns the bottom edge of the view 
to the bottom edge of the parent. 


Aligns the left edge of the view to 
the left edge of the parent. 


TV>c vic>m is aliped *to 

ihc faveyrt’s ad 
bottom cdys. 



CLICK ME 


android: 

layout.alignParentRight 


android: 

layout.alignParentTop 


Aligns the right edge of the view to 
the right edge of the parent. 


Aligns the top edge of the view to 
the top edge of the parent. 


click me - 

f 

The view is aliped 
"to 七 he par ⑶七 ’s v-ijhi 
-top edges. 


android: 

layout.centerlnParent 


android: 

layout.centerHorizontal 


android: 

layout.centerVertical 


Centers the view horizontally and 
vertically in the parent. 


Centers the view horizontally in the 
parent. 


Centers the view vertically in the 
parent. 


/ 


/ 

CLICK ME 

N 

\ 

? 

、 

/ 


CLICK ME - ^ 


/ 



CLICK ME 


\ 

/ 
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relative to siblings 

Positioning views relative to other views 



RelativeLayout 

LinearLayout 

GridLayout 


In addition to positioning views relative to the parent layout, you can also 
position views relative to other views. You do this when you want views to 
stay aligned in some way, irrespective of the screen size or orientation. 

In order to position a view relative to another view, the view you’re using 
as an anchor must be given an ID using the android : id attribute: 


android : id= n @+id/button click me" 


The syntax ’▼ @ + id" tells Android to include the ID as a resource in its 
resource file R.java. If you miss out the " + Android won’t add the ID as 
a resource and you’ll get errors in your code. 

Here’s how you create a layout with two buttons, with one button 
centered in the middle of the layout, and the second button positioned 
underneath the first: 

l/\feVe us'm^ as ar\ a^Kov- 

<RelativeLayout • • . > ^ stCov\d oy\C, so *»*t needs 

〈Button |P. ^ 

android : id= M @+id/button 一 click 一 me n 

android : layout_width="wrap_content n 
android : layout—height= n wrap_content n 
android : layout_centerInParent="true" 
android : text="@string/click_me n / > 

<Button 

android : layout_width="wrap_content" 
android : layout_height= M wrap_content" 

android : layout—alignLeft= n @+id/button_click 一 me 
android : layout_below= n @+id/button_click_me n 

android : text="@string/new—button—text" / > 
</RelativeLayout> 


12:22 


CLICK ME 


BELOW 


WicVc 3 SCfi-Oir\d 

\AY\Acrv\tai^ so 


Ir' Wtbcms ave aliy^d. 



The lines 

android : layout—alignLeft="@+id/button—click—me" 
android : layout_below="@+id/button_click_me" 

ensure that the second button has its left edge aligned to the left edge of 
the first button, and is always positioned beneath it. 
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Attributes for positioning views 
relative to other views 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


Here are some more of the attributes you can use when positioning 
views relative to another view. Add the attribute to the view you’re 
positioning, and sets its value to the view you’re positioning relative to: 


android : attribute= M @+id/view id’ 


Attribute 

android:layout_above 


android:layout_below 


What it does 

Put the view above the view you’re anchoring 
it to. 


YouV v*ic>w ^OCS above 

4- 


Puts the view below the view you’re anchoring 
it to. 





The view you’ve 

扣匕 hov’mg |七 "to 

Youv* v*ic>w 
^ocs bcloy/ 


android:layout_alignTop 


android:layout_alignBottom 


Aligns the top edge of the view to the top 
edge of the view you’re anchoring it to. 


Aligns the bottom edge of the view to the 
bottom edge of the view you’re anchoring it to. 



^\\\y\ tKc vicv/^s *bof 
AI "the view’s bottom 



android:layout_alignLeft 


Aligns the left edge of the view to the left 
edge of the view you’re anchoring it to. 


android ： layout_alignRight Aligns the right edge of the view to the right 

edge of the view you’re anchoring it to. 




vic^s Irf 七 


A113 灼七 he 
view’s \righi 
edges 


android:layout_toLeftOf 


Puts the right edge of the view to the left of 
the view you’re anchoring it to. 



Youv v*ic>w ^ocs bo *thc 七 


android ： layout_toRightOf Puts the left edge of the view to the right of 

the view you’re anchoring it to. 



Y^uV" view joes {jo 七 he v-ighi 
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margins 

Use margins to add distance between views 

When you use any of the layout attributes to position a view, the layout doesn’t 
leave much of a gap. You can increase the size of the gap between views by 
adding one or more margins to the view. 

As an example, suppose you wanted to put one view below another, but add 
50dp of extra space between the two. To do that, you’d add a margin of 50dp 
to the top of the bottom view: 

<RelativeLayout ... > 

<Button 

android : id= M @+id/button_click_me" 

... /> 



RelativeLayout 

LinearLayout 

GridLayout 


<Button 


android : layout_width= M wrap_content" 
android : layout_height="wrap_content n 
android : layout_alignLeft="@+id/button_click_me 
android : layout_below="@+id/button_click_me" 

android:layout marginTop= M 5Odp" 


android : text="@string/button_below" / > 
</RelativeLayout> 


d *to 

七 lie *fcof o-f 七 he bo*t*bom 
bu*t*tov> adds spade 
bc*t>wccr> *tv/o Vicv/s. 


Here’s a list of the margins you can use to give your views extra space. Add 
the attribute to the view, and set its value to the size of margin you want: 

android:attribute="10dp" 



Attribute 

android:layout_marginTop 


What it does 

Adds extra space to the top of the view. 


android:layout_marginBottom Adds extra space to the bottom of the view. 


android:layout_marginLeft 


Adds extra space to the left of the view. 


android:layout_marginRight 


Adds extra space to the right of the view. 
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the user interface 



RelativeLayout 


RGlativeLayout: a summary 


LinearLayout 


GridLayout 


Before we move on to our next type of layout, here’s a summary of 
how you create relative layouts. 


How you specify a relative layout 


You specify a relative layout using <RelativeLayout>. You must 
specify the layout width and height, but padding is optional: 

〈RelativeLayout xmlns : android= M http :// schemas.android.com/apk/res/android" 
android:layout—width= n match—parent n 
android: layout—height= n match—parent，' 
android:paddingBottom= M 16dp" 
android:paddingLeft= M 16dp" 
android:paddingRight="16dp" 
android:paddingTop= M 16dp"...> 

• •參 

</RelativeLayout> 


You caw position views relative to the layout of another view 


You specify where each view should be positioned by adding layout 
attributes to it. These attributes can position the view relative to the 
parent layout — for example, in the bottom right corner, or centered. 
You can also use attributes to position views relative to another view. 
You anchor one view to another using the view’s ID. 


You can add margins to views to increase the space around them 


When you use any of the layout attributes to position a view, the layout 
doesn’t leave much of a gap. You can increase the size of the gap 
between views by adding one or more margins to the view: 

android : layout_marginTop= n 5dp n 
android : layout—marginBottom= n 5dp ▼’ 
android : layout_marginLeft= M 5dp" 
android : layout_marginRight= M 5dp" 


So far we’ve just been working with the relative layout, but there’s 
another layout that’s commonly used too: the linear layout. Let’s 
take a closer look. 
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linear layout 


LmcarLayout displays views 
m a single row or column 

A linear layout displays its views next to each other, either vertically or 
horizontally. If it’s vertically, the views are displayed in a single column. If it’s 
horizontally, the views are displayed in a single row. 


V ： 


RelativeLayout 

LinearLayout 

GridLayout 


How you define a linear layout 

You define a linear layout using the <LinearLayout> element like this: 



You use 

<Lmcav"L.ayou*t> 

■to … e a Imcav- 

layout 


<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android' 

android : layout_width= M match_parent M These ave *thc sdme a*t*tv-*ibu*tcs wc 

android: layout—height= n match—parent n used *fov ouv vcla*tWc layout 

android : orientation= n vertical M - Display views vcvtidally. 



. > 


</LinearLayout> 


The android : layout_width, android : layout_height and 
android : orientation attributes are mandatory. 

android : layout_width and android : layout_height specify the 
layout width and height, just as it does with the relative layout. You use the 
android : orientation attribute to specify which direction you want to 
arrange views in. 

You arrange views vertically using: 


android:orientation= n vertical" 

You arrange views horizontally using: 

android:orientation="horizontal" 


h li^cav- 
layout v/i-th 
a wtidal 



f\ Imcav- layout Wi 七 a 



To Message send 
The views avc 'm a s'm^le v-ov/ 

i-P "the is liov-izjo^-tal. 
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the user interface 


A linear layout displays views in the 
order they appear m the layout XML 


V ： 


RelativeLayout 

LinearLayout 

GridLayout 


When you define a linear layout, you add views to the layout in the 
order in which you want them to appear. So if you want a text view 
to appear above a button, you must define the text view first: 


<LinearLayout ... > 


<TextView 



android:layout_width= n wrap_content M 
android:layout—height= n wrap—content” 
android:text= n @string/textViewl" /> 


<Button 


l-P you dc-f mc i\\t v'iom above 七 he 
button m 七 )< 亂，七 he view will 

affcav- above 七 he bu*bto 的 vj\\cy\ displayed- 



12:51 


This is a text view 


CLICK ME 


android:layout_width= n wrap_content M 
android: layout—height= n wrap_content'▼ 
android:text= n @string/click 一 me n /> 

</LinearLayout> 


With a linear layout, you only need to give your views IDs if 
you’re explicitly going to refer to them in your activity code. 

This is because the linear layout figures out where each view 
should be positioned based on the order in which they appear in 
the XML. Views don’t need to refer to other views in order to 
specify where they should be positioned. 

Just as with the relative layout, you can specify the width and 
height of any views using android : layout_width and 
android : layout—height. The code: 

android : layout—width= n wrap—content，' 




anctroicMayout 一 wicttli anct 
anctroict^ layout_keig[lit are 
manctatory attributes for all 
views, no matter wkick layout 
you use. 


means that you want the view to be just wide enough for its 
content to fit inside it — for example, the text displayed on a 
button or in a text view. The code: 

android : layout_width= M match_parent" 
means that you want the view to be as wide as the parent layout. 


Tliey can take tke values 
wrap 一 content ， matdk 一 parent ， 


or a specific ctimension value 
suck as l6ctp. 
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change layout 


Lcfs change up a basic linear layout 

At first glance, a linear layout can seem basic and inflexible. After all, 
all it does is arrange views in a particular order. To give you more 
flexibility, you can tweak your layouts appearance using some more of 
its attributes. To show you how this works, we’re going to transform a 
basic linear layout. 

The layout is composed of two editable text fields and a button. To 
start with, these text fields are simply displayed vertically on the screen 
like this: 



RelativeLayout 

LinearLayout 

GridLayout 


12:39 


Bdch view takes up 七 he 

least Possible arwouirt o*f .. 

i. '. Message 

vc\rti^a spade. 


We’re going to change the layout so that the button is 
displayed in the bottom-right corner of the layout, and one 
of the editable text fields takes up any remaining space. 
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Here's the starting point for the linear layout 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


The linear layout contains two editable text fields and a button. 
The button is labeled “Send”，and the editable text fields contain 
hint text values of “To” and “Message”. 


Hint text in an editable text field is text that’s displayed when 
the text field is empty. It’s used to give users a hint as to what 
sort of text they should enter. You define hint text using the 
android : hint attribute: 

<LinearLayout xmlns : android= M http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width= n match—parent，' 
android : layout—height="match—parent" 
android : paddingBottom="16dp" 
android : paddingLeft="16dp" 
android : paddingRight= M 16dp" 
android : paddingTop="16dp" 
android : orientation="vertical" 
tools : context^".MainActivity" > 


The values o( 
•tKcsc siv'm^s 
av-c dc-f med m 
as 

usudl- 



The cd'i*tablc 七作七 -f ields av-c as 
Vide as 七 layout- 


<EditText 

android : layout—width= n match—parent' 
android : layout—height= n wrap_content n 

android:hint="@string/to" /> ^ ahd\roid*hiht displays a hiht "to usev as -fco 

一 wha 七 ^ ^ould type ih -the edible f.cld. 

<EditText 

android : layout—width= n match—parent" 
android : layout—height= ， 'wrap—content’ 
android : hint="@string/message" / > 


<Button 



android : layout_width= M wrap_content 
android : layout_height= n wrap—content 
android : text= M @string/send" / > 
</LinearLayout> 

All of these views take up just as much vertical space in the 
layout as they need for their contents. So how do we make the 
Message text field taller? 


12:39 
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putting on weight 


2 

Make a view streeGcetch by adding weight 

All of the views in our basic layout take up just as much vertical 
space as they need for their content. What we actually want is to 
make the Message text field stretch to take up any vertical space in 
the layout that’s not being used by the other views. 


We v/airrt *to make 
Message 七 ^ t -f ield 七匕 

vcvtidally so 七 ha 七 rt Alls a 的 y 
spav-c spade *m layout- 





V 



RelativeLayout 

LinearLayout 

GridLayout 


In order to do this, we need to allocate some weight to the Message 
text field. Allocating weight to a view is a way of telling it to stretch 
to take up extra space in the layout. 

You assign weight to a view using 


android : layout_weight="number" 


where number is some number greater than 0. 

When you allocate weight to a view，the layout first of all makes sure 
that each view has enough space for its content. It makes sure that 
each button has space for its text, each editable text field has space 
for its hint, and so on. Once it’s done that, the layout takes any extra 
space, and divides it proportionally between the views with a weight 
of 1 or greater. 
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Adding weight to one view 

We need the Message editable text field to take up any extra 
space in the layout. To do this, we’ll set its layout—weight 
attribute to 1. As this is the only view in the layout with a weight 
value, this will make the text field stretch vertically to fill the 
remainder of the screen. Here’s the code: 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


<LinearLayout ... > 


<EditText 


android:layout—width= n match—parent n 
android:layout_height= M wrap_content 
android:hint= n @string/to" / > 



TW»S <Ea»tTc%t> <ButW 

v\o layovi 七一 sc*t- 
TV^cyll take as v-oow> as 
Cov\itY\i needs, but move. 



<EditText 

This view is the or>ly android: layout 一 width= n match—parent 

with ahy weight android: layout_height= M Odp M 

android: 呢 ig ht = nln 

hot heeded by ahy android:hint="@string/message 

the othev* views. 


Tiie o-P "the view will be by 

七 he Imeair layou 七 based ov\ ihc byou 七一 weight 
Sc-t-t'mj -the layou 七一 heiglvt 匕 Odp is ⑽代 

七 han settmj i-t -to 一 dorrteW. 


<Button 


android:layout_width= M wrap_content" 
android:layout_height="wrap_content n 
android:text 二 " @string/send" /> 

</LinearLayout> 

Giving the message editable text field a weight of 1 means that it 
takes up all of the extra space that’s not used by the other views 
in the layout. This is because neither of the other two views have 
been allocated any weight in the layout XML. 


The Message view has d weighi 
I- A s i"ts "the ov\\y view v/rth 
•rts v/eijh-t a^tbriburte sei, i 七 

expands "to take up any 
vc^rtidal spade m -the layou-t. 


12:42 
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more weight 


Adding weight to multiple views 

In this example, we only had one view with a weight attribute 
set. But what if we had more than one? 

Suppose we gave the To text field a weight of 1, and the 
Message text field a weight of 2 like this: 

<LinearLayout ... > 



RelativeLayout 

LinearLayout 

GridLayout 


<EditText 

android : layout_width= n match_parent" 

android:layout_height="Odp n 
android:layout_weight= n 1" 

android:hint="@string/to" / > 


<EditText 

android : layout_width= M match_parent n 

android:layout_height= n Odp M 
android:layout_weight= M 2" 

android:hint= M @string/message" / > 

參 • • 

</LinearLayout> 


To figure out how much extra space each view takes up, start by 
adding together the layout—weight attributes for each view. 
In our case, this is 1+2=3. The amount of extra space taken 
up by each view will be the view’s weight divided by the total 
weight. The To view has a weight of 1, so this means it will take 
up 1/3 of the remaining space in the layout. The Message view 
has a weight of 2, so it will take up 2/3 of the remaining space. 


12:43 
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the user interface 


Use gravity to specify 
where text appears m a view 

The next thing we need to do is move the hint text inside the 
Message text field. At the moment, it’s centered vertically 
inside the view. We need to change it so that the text appears 
at the top of the text field. We can achieve this using the 
android : gravity attribute. 

The android : gravity attribute lets you specify how you 
want to position the contents of a view inside the view — for 
example, how you want to position text inside a text field. If you 
want the text inside a view to appear at the top, the following 
code will do the trick: 

android: gravity:’▼ top" 

We’ll add an android : gravity attribute to the Message text 
field so that the hint text moves to the top of the view: 

<LinearLayout ... > 


<EditText 

android:layout—width= n match_parent" 


V ： 


RelativeLayout 

LinearLayout 

GridLayout 



android:layout 一 height="Odp" 
android: layout 一 weight=" 1 ▼' 

android:gravity:"top" - 

android:hint= M @string/message" / > 


Pisplay mside 七 wt Acid 

a*b *bKc -top -field- 


</LinearLayout> 

Test drive - 

Adding the android : gravity attribute to the Message text field 
moves the hint text to the top of the view, just like we want. 

You’ll find a list of the other values you can use with the 
android : gravity attribute on the next page. 


12:46 


To 


Message 

TKc ^ssay iVmt 
y \ o\n apfeav-s a*t 

of V*IC>W- 


SEND 
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Using the awdroid.-gravity attribute: 
a list of values 

Here are some more of the values you can use with the 
android : gravity attribute. Add the attribute to your view, 
and set its value to one of the values below: 

android : gravity= n value" 



RelativeLayout 

LinearLayout 

GridLayout 


Value 

top 

bottom 

left 

right 

center_vertical 

center_horizontal 

center 


What it does 


Puts the view’s contents at the top of the view. 

Puts the view’s contents at the bottom of the view. 


Puts the view’s contents at the left of the view. 


Puts the view’s contents at the right of the view. 
Centers the view’s contents vertically. 

Centers the view’s contents horizontally. 

Centers the view’s contents vertically and horizontally. 


fill 一 vertical 

fill_horizontal 

fill 


Make the view’s contents fill the view vertically. 
Make the view’s contents fill the view horizontally. 

Make the view’s contents fill the view. 


anctroict ： gravity lets you say wkere 
you want tke view’s contents to 
appear inside tke view. 
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Move the buttow to the right 
with layout 一 gravity 

There’s one final change we need to make to our layout. The Send 
button currently appears in the bottom-left corner. We need to move it 
over to the right so that it’s in the bottom-right corner instead. To do 
this, we’ll use the android : layout_gravity attribute. 

The android : layout_gravity attribute lets you specify where 
you want a view in a linear layout to appear in its enclosing space. You 
can use it to push a view to the right, for instance, or center the view 
horizontally. To move our button to the right, we’d need to add the 
following to the button: 

android : layout_gravity="right" 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 



But why do we need 
to use layout—gravity to 
move the button? Earlier on 
we saw the layout—alignRight 
attribute—surely that would 
do it? 


The android:layout_alignRight attribute only 
applies to relative layouts. 

Layouts have some attributes in common, such as 
android : layout_width and android : layout_ 
height. Many attributes, however, are specific to one 
particular type of attribute. 

Most of the attributes we saw for the relative layout don’t 
apply to linear layouts. Linear layouts use the concept of 
gravity instead, so we have to use 

android : layout_gravity= M right" 
if we want to move a view to the right. 

You’ll see a list of some of the other values you can use with 
the android : layout_gravity attribute on the next page. 
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layout-gravity 


More values you can use with the 
awdroid.iayout^gravity attribute 

Here are some of the values you can use with the 

android : layout_gravity attribute. Add the attribute to 

your view, and set its value to one of the values below: 

android : 1ayout_gravity="value" 


V ： 


RelativeLayout 

LinearLayout 

GridLayout 


Value 

top, bottom, left, right 


What it does 

Puts the view at the top, bottom, left, or right of its 
container. 


start, end 

center_vertical, center_horizontal 
center 


Puts the view at the start or end of its container. 

Centers the view vertically or horizontally in its container. 

Centers the view vertically and horizontally in its 
container. 


fill_vertical ， fill_horizontal 


Grow the view so that it fills its container in a vertical or 
horizontal direction. 


fill 


Grow the view so that it fills its container in a vertical 
and horizontal direction. 


androict: lay out—gravity lets you say wkere you 
want views to appear in tkeir available space. 

androict: lay out—gravity deals witk tke placement 
oi tke view itself，wkereas anctroict: gravity deals 
witk kow to display tke view contents. 
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the user interface 

RelativeLayout 
LinearLayout 
GridLayout 

Here’s the full code for the linear layout: 


The full linear layout code 


V ： 


<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width="match—parent" 
android : layout—height= n match—parent ，’ 
android : paddingBottom= M 16dp" 
android : paddingLeft="16dp" 
android : paddingRight="16dp" 
android : paddingTop= M 16dp" 
android : orientation= M vertical" 
tools : context= M .MainActivity" > 


<EditText 

android : layout_width="match_parent n 
android : layout_height="wrap_content" 
android : hint="@string/to" / > 


<EditText 

android : layout_width= n match_parent" 

android : layout_height= n Odp" 

android : layout_weight="1" 

android : gravity="top" 

android : hint="@string/message" / > 


<Button 

android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 

android : layout—gravity:"right'▼ w 

android : text= M @string/send" / > \ 

</LinearLayout> ar^oid ， av ’ •切 is di^r— — a 产二 .d 切 ou 七一 

yavi*ty* andv-oid^v-avixy v-dates -to tnc 

o( viev/, 一 yav/rty 

vclatcs bo viev/ 
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summary 


LmcarLayout: a summary 

Here’s a summary of how you create linear layouts. 

How you specify a linear layout 

You specify a linear layout using <LinearLayout>. You must 
specify the layout width, height, and orientation, but padding is 
optional: 

〈LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
android : layout—width="match—parent" 
android : layout—height= n match—parent▼' 
android : orientation="vertical" 

... > 


4 


RelativeLayout 

LinearLayout 

GridLayout 


</LinearLayout> 


Views get displayed w the order they appear 

When you define a linear layout, you add views to the layout in the 
order in which you want them to appear. 

Stretch views using weight 

By default, all views take up just as much space as necessary for their 
content. If you want to make one or more of your views take up more 
space, you can use the weight attribute to make it stretch: 

android : layout_weight="1" 

Use gravity to specify where a view's contents appear w a view 

The android : gravity attribute lets you specify how you want to 
position the contents of a view inside the view — for example, how you 
want to position text inside a text field. 

Use layoirLgravity to specify where a view appears m its enclosing space 

The android : layout_gravity attribute lets you specify where 
you want a view in a linear layout to appear in its enclosing space. You 
can use it to push a view to the right, for instance, or center the view 
horizontally. 


That’s everything we’ve covered on linear layouts. There’s one more 
view group we’re going to look at: the grid layout. 
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cfo|terpen your pencil 


Here's the layout XML for the Beer Adviser app we created in 
Chapter 2. Change it to a linear layout that produces the output 
below. 


<RelativeLayout xmlns : android= M http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= n match—parent" 
android : layout—height= n match—parent，' 
android : paddingBottom 二 ▼ ， 16 dp" 
android : paddingLeft="16dp" 
android : paddingRight="16dp" 
android : paddingTop= M 16dp" 
tools : context= M .FindBeerActivity" > 

<Spinner 

android : id="@+id/color" 
android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android : layout_alignParentTop="true" 
android : layout_centerHorizontal="true n 
android : layout_marginTop="37dp" 
android : entries="@array/beer_colors" / > 


<Button 

android : id="@+id/f ind—beer，' 
android : layout_width="wrap_content n 
android : layout_height="wrap_content" 
android : layout_alignLeft= M @+id/color" 
android : layout_below="@+id/color" 
android : text="@ string/find—beer" 
android : onClick="onClickFindBeer" / > 


<TextView 

android : id="@+id/brands 


android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android : layout—alignLeft= ， '@+id/find—beer 
android : layout_below= M @ + id/find—beer，' 
android : layout_marginTop="18dp" 
android : text= M @string/brands" / > 
</RelativeLayout> 


\i a 吖 w most stylish layout" a^ds, but 

s« *»-f you y ><MLto ^odutc ^»s. 











sharpen solution 


f^|terpen your pencil 


Here's the layout XML for the Beer Adviser app we created in 
Chapter 2. Change it to a linear layout that produces the output 
below. 


rt 

*to d I'mcav* 
layoui- 


j^Se^ra-i^T^LinearLayout xmlns : android="http : // schemas . android. com/apk/res/android' 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width="match 一 parent" 
android : layout 一 height= n match—parent▼' 
android : paddingBottom="16dp" 

layou-ts use dY\ ahdv-oid ： o\ric^-t3-tior> 
aiiv-ibuic. Use w hov-iio^tal w -fco display views 
"to hoviiorrtally. 


android : paddingLeft=" 16dp" 
android : paddingRight="16dp" 
android : paddingTop="16dp" 

android : orientation= n horizontal" 

tools : context=".FindBeerActivity' 


> 


<Spinner 

android : id="@+id/color" 

android : layout—width= n wrap—content" 

Wlc do 灼’七 these Imcs. 

android : entries^"@array/beer_colors" /> 


android : layout height= M wrap content" 



<Button 

android : id="@+id/find_beer" 
android : layout—width=''wrap—content，' 
android : layout_height= n wrap_content" 

後 doh't heed these lihes. 

android : text=" @ string/find—beer▼' 
android : onClick="onClickFindBeer" / > 



Charge rt 
*to a Imcav- 


layou*t- 


< 


<TextView 

android : id= n @+id/brands" 
android : layout—width= n wrap_content n 
android : layout—height= n wrap_content n 

android : text=" @ string/brands ，，/ > 

Rarte^HrveLinearLayout> 




\Mt dov^i v\ttd tV^csc I'mcs. 
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ftridLayout displays views m a grid 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


A grid layout splits the screen up into a grid of rows and columns, 
and allocates views to cells: 



Bddh o( 

"these ^ 

direds is 

a all . 、 



GridLayout 
requires 
API level 
14 or 
above. 


If you plan on using a 
grid layout, make sure 
your app uses a minimum 
SDK of AP114. 


How you define a grid layout 

You define a grid layout in a similar way to how you define the 
other types of layout, this time using the <GridLayout> element: 



〈GridLayout xmlns : android="http : // schemas . android. com/apk/res/android' 

avc the same a*tVibu*tcs 


android : layout_width= M match_parent 
android : layout—height=' ， match—parent 

android : columnCount= n 2 n ^ - - 


飞 Tiicsc 

„^)uscd . 


-fov ouv* o*thcv* layout- 


> 


ftow rvtdhy dolumhS you Vi 
layout -to have U this cast, 2 


ou\r 

n 


</GridLayout> 


You specify how many columns you want the grid layout to have 
using: 

android : columnCount= M number M 


where number is the number of columns. You can also specify a 
maximum number of rows using: 

android : rowCount= n number n 

but in practice you can usually let Android figure this out based on 
the number of views in the layout. Android will include as many 
rows as is necessary to display the views. 
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grid layout 


Adding views to the grid layout 

You can add views to a grid layout in a similar way to 
how you add views to a linear layout: 

<GridLayout ... > 



RelativeLayout 

LinearLayout 

GridLayout 


<TextView 

android : layout—width= n wrap—content” 
android : layout_height= n wrap_content" 
android : text= n @string/textview n /> 


<Button 

android : layout_width= n wrap—content” 
android : layout_height= n wrap—content” 
android : text= n @string/click 一 me n /> 

<EditText 

android : layout_width= n wrap 一 content” 
android : layout_height= n wrap—content” 
android : hint= n @string/edit" /> 

</GridLayout> 


Just like a linear layout, there’s no need to give your 
views IDs unless you’re explicitly going to refer to 
them in your activity code. The views don’t need to 
refer to each other within the layout, so they don’t 
need to have IDs for this purpose. 

By default, the grid layout positions your views in the 
order in which they appear in the XML. So if you 
have a grid layout with two columns, the grid layout 
will put the first view in the first position, the second 
view in the second position, and so on. 

The downside of this approach is that if you remove 
one of your views from the layout, it can drastically 
change the appearance of the layout. To get around 
this, you specify where you want each view to appear, 
and how many columns you want it to span. 



190 Chapter 5 





Lcfs create a new grid layout 



To see this in action, we’ll create a grid layout that specifies which 
cells we want views to appear in, and how many columns they 
should span. The layout is composed of a text view containing the 
text “To”，an editable text field that contains hint text of “Enter 
email address”，an editable text field that contains hint text of 
“Message”，and a button labeled “Send ”： 


is simile -to -the example wc used ^4 
wi 七 h lihcav layout, 

theire S how a To itYi -field at the 
3hd the Schd bu-t-toh is ^ch-tc^cd 
hoHzoh-blly at -the bottom. 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


Here's what weYc going to do 



Sketch the user interface, and split it into rows and columns. 

This will make it easier for us to see how we should construct our layout. 



Build up the layout row by row. 
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sketch it 


Well start with a sketch 

The first thing we’ll do to create our new layout is sketch it out. That way 
we can see how many rows and columns we need, where each view should 
be positioned, and how many columns each view should span. 



RelativeLayout 

LinearLayout 

GridLayout 


1st 

column 


2nd 

column 


1st row 


2nd row — > 


3rd row — > 


To 





The first row has a text view in the 
first column with text of 、、 To ’〜 and an 
editable text field in the 2nd column 
with a hint of ''Enter email address". 


The second row has an editable text 
field with text of 、、 Message". It starts 
in the first column and spans across the 
second. It needs to fill the available 
space. 


The third row has a button with text of 


y 、、 5end”. Ifs centered horizontally across 
both columns, which means it needs to 
span the two columns. 


The grid layout needs two columns 


We can position our views how we want if we use a grid layout with two columns: 


〈GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width="match—parent" 
android : layout—height= n match—parent" 
android : paddingBottom= M 16dp" 
android : paddingLeft="16dp n 
android : paddingRight="16 dp" 
android : paddingTop= M 16dp" 
android : columnCount= M 2 n 
tools : context= M .MainActivity" > 

</GridLayout> 


Now that we have the basic grid layout defined, we can start adding views. 
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Row 0: add views to specific rows and columns 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


The first row of the grid layout is composed of a text view in the 
first column, and an editable text field in the second column. You 
start by adding the views to the layout: 


To 



Bmicv' email dddl\ress 




<GridLayout...> 

<TextView 

android : layout_width= n wrap—content” 
android : layout_height= M wrap_content M 
android:text="@string/to" /> 


<EditText 


You can use anctroict: gravity 
and anctroict: lay out—gravity 
attributes witk grid layouts. 


android : layout 一 width: n wrap—content” 
android : layout— height= n wrap 一 content” 
android : layout—gravity= n f ill—horizontal'▼ 
android : hint= n @ string/to 一 hint ▼▼ /> 

</GridLayout> 


You use layou*t_5v-av*i*ty *m yid layouts -too. 
^ - WlcVc us'm^ •f ill—iiovizjorrtal because >wc v/a 灼七 
七 he editable -f ield *to -f ill 

hov*iz«oyrtal spade- 


Then you use the android : layout_row and android : layout—column 
attributes to say which row and column you want each view to appear in. The 
row and column indices start from 0, so if you want a view to appear in the first 
column and first row, you use: 


android : layout_row= n 0 n 
android : layout column= 



Colurw^s artdi \rows s-tav-t O, 
so 七 his \rc-Pc\rs {o ihc -Pivsi vow 
and -Pi\rs-t dolumr>- 


Let’s apply this to our layout code by putting the text view in column 0, and the 
editable text field in column 1. 


Row and column 
indices start at 0. 
layout 一 coluitin = ， ’n” 
refers to column 
n+1 in tke display. 


<GridLayout...> 
<TextView 



</GridLayout> 
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spanning co/umns 


Row 1: make a view span multiple columns 

The second row of the grid layout is composed of an editable text 
field that starts in the first column and spans across the second. 

The view takes up all the available space. 

To get a view to span multiple columns, you start by specifying 
which row and column you want the view to start in. We want the 
view to start in the first column of the second row, so we need to 


4 


RelativeLayout 

LinearLayout 

GridLayout 


use: 


android : layout_row="1 n 
android : layout_column= n 0" 

We want our view to go across two columns, and we can do this 
using the android : layout_columnSpan attribute like this: 

android : layout—columnSpan= n number'▼ 

where number is the number of columns we want the view to 
span across. In our case, this is: 

android : layout columnSpan="2" 


Row 1 — ^ 



Column span = 2 


Putting it all together, here’s the code for the Message view: 


<GridLayout...> 

<TextView... / > ^^ N 
<EditText. . . /> 

<EditText 


These av-c "the views 


wc 


added oy\ -the las-t pay (or vow O. 


android : layout—width= n wrap 一 content” 
android : layout_height= n wrap_content" 

android: layout_gravity= n fill" ^/c v/a 灼七七 he view *to -fill 七 he available spade, 

android: gravity: n top n 〈 _ *(*ov "to 

android : layout_row="1" 

android : layout column= n O n ^ - - l i • i ^ ^ 

一 I nc view starts m O, av\d spans Z 

android: layout—columnSpan= n 2 n ^ dolurw^s. 
android : hint= n @string/message" /> 

</GridLayout> 


Now that we’ve added the views for the first two rows, all we 
need to do is add the button. 
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the user interface 


Row 1 : make a view span multiple columns 

We need the button to be centered horizontally across the 
two columns like this: 


4 


RelativeLayout 

LinearLayout 

GridLayout 


Column 

0 


Column 

1 





Row 2 — > 









Column span = 2 



Layout Magnets 

We wrote some code to center the Send button in the third row of the grid layout, but a sudden 
breeze blew some of it away. See if you can reconstruct the code using the magnets below. 


<GridLayout...> 


<TextView... /> 

<EditText.../> 
<EditText.../> 



These a\rc 七 he views we’ve already added. 


<Button 

android : layout_width= n wrap_content" 
android : layout—height 二 n wrap_content n 

android : layout_row= 

android : layout_column= 

android : layout_gravity= 

android : layout_columnSpan= 

android:text="@string/send" / > 



► Answers on page 224 


</GridLayout> 
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layout code 


The full code for the grid layout 




RelativeLayout 

LinearLayout 

GridLayout 


<GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= n match—parent ’， 
android : layout—height= n match—parent ▼’ 
android : paddingBottom= M 16dp" 
android : paddingLeft="16dp" 
android : paddingRight="16 dp" 
android : paddingTop="16dp" 
android : columnCount= n 2▼' 
tools : context= M .MainActivity" > 


<TextView 

android : layout_width="wrap_content 
android : layout_height= M wrap_content 
android : layout_row= M 0" 
android : layout_column= M 0" 
android:text="@string/to" / > 

<EditText 

android : layout_width="wrap_content 
android : layout—height= n wrap 一 content 
android : layout_gravity= n fill—horizontal 
android : layout_row 二 ▼，0 n 
android : layout—column 二 ▼ ， 1 n 
android:hint="@string/to hint" / > 


<EditText 

android 

android 

android 

android 

android 

android 

android 

android 


layout_width= n wrap—content 
layout_height= n wrap—content 
layout_gravity= M fill" 
gravity= M top" 
layout_row="1" 
layout_column="0" 
layout_columnSpan= M 2" 
hint= M @string/message" / > 


<Button 

android : layout_width= n wrap—content 
android : layout_height= n wrap 一 content” 
android : layout_row= n 2 n 
android : layout_column= n 0" 

android : layout_gravity= " center—horizontal，▼ 
android : layout_columnSpan="2" 
android:text="@string/send" /> 

</GridLayout> 



The button spav>s *t>wo 
dolumy>s ; 

-fvom V*ov/ Z £.olumy> 

I. |Vs dcr>*tcv-cd 
Ko\r'izjoy>*tally- 
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ftridLayout: a summary 

Here’s a summary of how you create grid layouts. 

How you specify a grid layout 

You specify a grid layout using <GridLayout>. You specify how 
many columns you need using the android : columnCount 
attribute. You say how many rows you need using the 
android : rowCount attribute: 



the user interface 

RelativeLayout 

LinearLayout 

GridLayout 


<GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
android: layout—width= ， 'match—parent n 
android:layout—height= n match—parent n 
android:columnCount="2" 

... > 


</GridLayout> 

Specify which row and column each view should start iw 

You use the android : layout_row and android : layout_ 
column attributes to say which row and column you want each view 
to appear in. The row and column indices start from 0, so if you want 
a view to appear in the first column and first row, you use: 

android : layout_row="0" 
android : layout_column="0" 

Specify how many columns each view should span 

You use the android : layout_columnSpan attribute to specify 
how many columns each view should span. If you want a view to span 
across two columns, for instance, you use: 

android : layout_columnSpan= n 2" 
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exercise 




Three of the five screens below were 
made from layouts on the opposite 
pa^e. Your job is to match each of 

S 」 the three layouts to the 

screen that tke layout 
would produce. 

厂 ❺ 


o 





❺ 
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the user interface 



<GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= ，， match—parent，' 
android : layout—height= n match—parent ▼’ 
android : columnCount="3" 
tools : context= M .MainActivity" > 

<Button 

android : layout_width= M wrap_content n 
android : layout_height="wrap_content" 
android : layout_gravity= M fill" 
android : layout_columnSpan= M 3" 
android : text= M @string/hello" / > 

</GridLayout> 



<GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= ， 'match—parent" 
android : layout—height= n match—parent ▼’ 
android : columnCount="2" 
tools : context= M .MainActivity" > 

<Button 

android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android : layout_gravity= M fill" 
android : layout_columnSpan= M 2" 
android : text= M @string/hello" / > 

<Button 

android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android:text= M @string/hi M / > 

</GridLayout> 



<GridLayout xmlns : android= n http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= ， 'match—parent，' 
android : layout—height= n match—parent ，’ 
android : columnCount="2" 
tools : context= M .MainActivity" > 

<Button 

android : layout_width= M wrap_content n 
android : layout_height="wrap_content" 
android : layout_row="0" 
android : layout_column="0" 
android : layout_columnSpan= M 2 n 
android : text= M @string/hello" / > 

<Button 

android : layout_width= M wrap_content n 
android : layout_height="wrap_content" 
android : layout_row="1" 
android : layout_column="0" 
android:text= M @string/hi" / > 

</GridLayout> 
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solution 




BE th^ 

Three of the five screens below were 
made from layouts on the opposite 
pa^e. Your job is to match each of 

the lliree layouts to the 
screen that the layout 
would produce. 



NohC o-p -fch 




HELLO! 


layouts pvodudc 

these SdV"CChS. 




o 


<GridLayout xmlns : android= 

"http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width= M match_parent" 
android : layout_height="match_parent" 
android : columnCount="3" 
tools : context:".MainActivity" > 

<Button 


android : layout_width= n wrap—content，' 
android : layout_height="wrap_content 
android : layout_gravity= M f ill" 
android : layout_columnSpan= M 3" 
android : text= M @string/hello" / > 

</GridLayout> 


This has oY\t 
button 七 ha 七 

-f ills SdVCCy>. 



o 


© <GridLayout xmlns : android= 

"http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout 一 width= n match—parent，' 
android : layout 一 height= n match—parent" 
android : columnCount="2" 
tools : context= M .MainActivity" > 

<Button 

android : layout_width="wrap_content" 
android : layout 一 height 二 , ’wrap_content 
android : layout_gravity="fill" 
android : layout_columnSpan="2 " 
android : text="@string/hello" / > 

<Button 

android : layout—width= n wrap 一 content" 
android : layout 一 height= n wrap_content 
android:text="@string/hi" / > 

</GridLayout> 


This birtto 灼 

•fills 七 he 
leav'm^ spade 
■fo\r a^o^thev* ov\c 

i*t- 
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o 


0 <GridLayout xmlns : android= 

"http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width= M match_parent n 
android : layout—height="match—parent" 
android : columnCount="2" 
tools : context=".MainActivity" > 

<Button 


android : layout_width= M wrap_content n 
android : layout_height="wrap_content" 
android : layout_row="0" 
android : layout_column="0" 
android : layout_columnSpan= M 2 
android : text= M @string/hello" / > 
<Button 

android : layout_width= M wrap_content n 
android : layout—height= n wrap_content，' 
android : layout_row="1" 
android : layout_column= n 0" 
android:text= M @string/hi" / > 
</GridLayout> 


*tV>ou^K 
七 he button 
sf>dv>s 七 v/o 
dolum^s, y/C 

*tcll *to 

-f ill SdVCCir> 

hov*izjoy>*tally- 


Layouts and ftUl componeHts have a lot m common 

You may have noticed that all layout types have attributes in 
common. Whichever type of layout you use, you must specify 
the layout width and height using the android : layout_ 
width and android : layout_height attributes. This 
isn’t just limited to layouts — the android : layout_width 
and android : layout—height are mandatory for all GUI 
components too. 


This is because all layouts and GUI components are 
subclasses of the Android View class. Let’s look at this in 
more detail. 
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views 


WJI components area type of View 

You’ve already seen that GUI components are all types of views — behind 
the scenes, they are all subclasses of the android. view. View 
class. This means that all of the GUI components you use in your user 
interface have attributes and behavior in common. They can all be 
displayed on the screen, for instance, and they can say how tall or wide 

they should be. Each of the GUI components you use in your user air>dv*o'id v*ic>w \/iC>w is base 

interface take this basic functionality, and extend it. dlass o( dll 七 he ^U| 



Layouts area type of View called a View 给 roup 

It’s not just the GUI components that are a type of view. Under the hood, 
a layout is a special type of view called a view group. All layouts are 
subclasses of the android. view. ViewGroup class. A view group is 
a type of view that can contain other views. 



A GUI component is a 

type of view, an object 
wkicli takes up space 
on tke screen* 


A layout is a type of 
view group, wkick is 
a special type of view 
tkat can contain otker 
views* 
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the user interface 


What being a view buys you 

A View object occupies rectangular space on the screen. It includes 
the functionality all views need in order to lead a happy helpful life in 
Androidville. Here are some of the areas we think are the most important: 

Getting and setting properties 

Each view is a Java object behind the scenes, and that means you 
can get and set its properties in your activity code. As an example, 
you can retrieve the value selected in a spinner or change the text 
in a text view. The exact properties and methods you can access 
depend on the type of view. 


To help you with this, each view can have an ID associated with it 
so that you can refer to it in your code. 

Size and position 

You can specify the width and height of views so that Android 
knows how big they need to be. You can also say whether any 
padding is needed around the view. 

Once your view has been displayed, you can retrieve the position 
of the view, and its actual size on the screen. 

Focus handling 

Android handles how the focus moves depending on what the 
user does. This includes responding to any views that are hidden, 
removed, or made visible. 

Event handling and listeners 

Each of your views can respond to events. You can also create 
listeners so that you can react to things happening in the view. As 
an example, all views can react to getting or losing the focus, and 
a button (and all of its subclasses) can react to being clicked. 


ficv*c some o-p -the 1/icw 
methods you 乙 use ih youv- 
3d 七 ivi 七 y dodc* -fiis "these 3\rc \y\ 
the base l/icw dass, tlicyVc 
-fco all Views ay\d view 


giroups. 




android.view.View 

getld() 

getHeightO 

getWidth() 

setVisibility(int) 

findViewByld(int) 

isClickableO 

isFocusedO 

requestFocusQ 


As a view group is also a type of view, this means that all layouts and GUI 
components share this common functionality. 
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view hierarchy 


A layout is really a hierarchy of Views 


The layout you define using XML gives you a hierachical tree of views and 
view groups. As an example, here’s a relative layout containing a button 
and an editable text field. The relative layout is a view group, and 
the button and text field are both views. The view group is the view’s 
parent, and the views are the view group’s children: 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android 


> 


r 

.,/>. / <Button 

Wt vc lc-r*t ou*t a o .. 

lot the android:ld=，，@+ld/send 

The key thmj is - V • • • /> 

the views the view 

youf do^ta'ms. 〈EditText 

android: id="@+id/message 

. . . /> 


TV>c vclativc layout 



The birtton 




The editable 
-field 


</RelativeLayout> 


Behind the scenes, when you build your app, the layout XML is 
converted to a ViewGroup object containing a tree of Views. In the 
example above, the button gets translated to a Button object, and 
the text view gets translated to a TextView object. Button and 
TextView are both subclasses of View. 



</ 


The vclativc layout 


layout.xml 


The birtfeon 


The editable 
-field 


View 


View 


This is the reason why you can manipulate the views in your layout 
using Java code. Behind the scenes, all of the views are rendered to Java 
View objects. 
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Playing with views 

Let’s look at the most common GUI components. You’ve already seen 
some of these, but we’ll review them anyway. We won’t show you the 
whole API for each of these — just selected highlights to get you started. 


Text view 

Used for displaying text. 


This is a tejet view 


Pefihmg it m XML 


You define a text view in your layout using the <TextView> element. 
You use android : text to say what text you want it to display, usually 
by using a string resource: 


<TextView 

android : id= n @ + id/text_view" 
android : layout—width= n wrap 一 content" 
android : layout—height= n wrap_content，' 
android:text="@string/text" / > 


The Text View API includes many attributes to control the text view’s 
appearance, such as the text size. To change the text size, you use the 
android : textSize attribute like this: 

android : textSize= M 14sp M 


android.view.View 


△ 


android.widget.TextView 


You specify the text size using scale-independent pixels (sp). Scale- 
independent pixels take into account whether users want to use large 
fonts on their devices. A text size of 14sp will be physically larger on a 
device configured to use large fonts than on a device configured to use 
small fonts. 


Using it w your activity code 

You can change the text displayed in your text view using code like this: 

TextView textView = (TextView) findViewById(R.id.text_view); 
textView.setText("Some other string ”）； 
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editable text fields 


Edit Text 

Like a text view, but editable. 

Pefinmg it w XML 

You define an editable text view in XML using the <EditText> element. 
You use the android : hint attribute to give a hint to the user as to how to 
fill it in. 



android.view.View 

A 


android.widget.TextView 

I 參 


<EditText 

android:id= M @ + id/edit_text" 
android:layout_width="wrap_content" 
android: layout—height= n wrap—content，' 
android:hint="@string/edit_text" / > 


android.widget.EditText 


You can use the android : inputType attribute to define what type of 
data you’re expecting the user to enter so that Android can help them. As an 
example, if you’re expecting the user to enter numbers, you can use 

android : inputType="number" 


to provide them with a number keypad. Here are some more of our favorites: 


Value 


What it does 



You CdiY\ -f md the cr>*t*ivc 
list m *tKc oY\[\v\t A^dv-oid 
dcvcIofCV dotumCir>*t3*tlOir>. 


phone 

textPassword 

textCapSentences 

textAutoCorrect 


Provides a phone number keypad. 

Displays a text entry keypad, and your input is concealed. 
Capitalizes the first word of a sentence. 

Automatically corrects the text being input. 


You can specify multiple input types using the | character. As an example, 
to capitalize the first word of a sentence and automatically correct any 
misspellings, you’d use: 

android : inputType= M textCapSentences|textAutoCorrect" 


Using it w your activity code 

You can retrieve the text entered in an editable text view like this: 

EditText editText = (EditText) findViewByld(R.id.edit_text); 
String text = editText.getText() .toString (); 
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Puttow 


Usually used to make your app do something when the 
button’s clicked. 



Pefmmg it w XML 

You define a button in XML using the <Button> element. You use 
the android : text attribute to say what text you want the button to 
display: 

<Button 

android:id= n @ + id/button" 
android:layout_width="wrap_content" 
android:layout—height= n wrap_content n 
android:text="@string/button_text" / > 

Using it w your activity code 

You get the button to respond to the user clicking it by using the 
android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android : onClick= M onButtonClicked" 



You then define the method in your activity like this: 

/** Called when the button is clicked */ 
public void onButtonClicked(View view) { 

// Do something in response to button click 



Layout 


o 

Activity 


you are here ► 


207 

















toggle button 


Toggle buttow 


A toggle button allows you to choose between two states by clicking a button. 


This is y/ha 七 "the 

bu"tfco 灼 looks .^ 
like wlich its o-Pf. 

Pefinmg it w XML 



W\\tv\ you dlidk 
七 he *to^lc 
buttdi 七 

*to 

bem^ o^. 


You define a toggle button in XML using the <ToggleButton> element. 
You use the android : text On and android : textOf f attributes to say 
what text you want the button to display depending on the state of the button: 

<ToggleButton 

android:id="@+id/toggle_button" 
android:layout_width= M wrap_content" 
android:layout—height= n wrap—content n 
android:textOn="@string/on" 
android:textOff= M @string/off" / > 


Using it iw your activity code 

You get the toggle button to respond to the user clicking it by using the 
android : onClick attribute in the layout XML. You give it the name of the 
method you want to call in your activity code: 

TKis is c%ad*tly same 

android : onClick= n onToggleButtonClicked M ^ ^ wthod 3 

y>ov-mdl butto 灼 yb dlidkcd- 

You then define the method in your activity like this: 

/** Called when the toggle button is clicked */ 
public void onToggleClicked(View view) { 

// Get the state of the toggle button. 
boolean on = ((ToggleButton) view).isChecked(); 



if (on) { 
"On 
} else { 

// Off 

} 


This \reiums i\ruc i-f 七 he -toggle bui^to^ is oy\, 
-false i-f ihc -toggle bu-t-to^ is o^-f. 
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Switch 


A switch is a slider control that acts in the same way as a toggle button. 


This is -the sy/i 
when i^t’s o((. 




This is *tiic 
sv/rtdh v/hcir> 
•rt’s orv 


Pefinmg it w XML 

You define a toggle button in XML using the 〈 Switch 〉 element. You use 
the android : text On and android : textOf f attributes to say what 
text you want the switch to display depending on the state of the switch: 



A Switch 
requires API 
level 14 or 
above. 


If you want 
to use a switch in your 
app, make sure it uses a 
minimum SDK of API level 
14. 


<Switch 

android: id="@ + id/switch—view '， 
android: layout 一 width= ， 'wrap_content n 
android: layout 一 height= n wrap_content ，， 
android:textOn="@string/on" 
android:textOff="@string/off" / > 

Using it w your activity code 

You get the switch to respond to the user clicking it by using the 
android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android : onClick= M onSwitchClicked" 

You then define the method in your activity like this: 

/** Called when the switch is clicked */ 
public void onSwitchClicked(View view) { 

// Is the switch on? 

boolean on = ((Switch) view).isChecked(); 

This is VCV"Y si mi lav* CoAt *to 七七 
used wrtii i\\t *to 咖 bu 七 W 


if (on) 

{ 

// 

On 

} else 

{ 

// 

Off 
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check boxes 


Check boxes 

Check boxes let you display multiple options to users. They can then select 
whichever options they want. Each of the checkboxes can be checked or 
unchecked independently of any others. 


Hcv-c have *t>wo 

Uscv-s dhoosc milk, su^av, 

bo*tii m'llk av>d su^av, ov y>c*i*thcv. 


I?efiwiwg them in XML 

You define each checkbox in XML using the <CheckBox> element. You 
use the android : text attribute to display text for each option: 

<CheckBox android:id="@+id/checkbox_milk" 
android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android : text= M @string/milk" / > 

<CheckBox android:id="@+id/checkbox_sugar" 
android : layout_width= M wrap_content n 
android : layout_height="wrap_content" 
android : text= M @string/sugar" / > 

Using them w your activity code 

You can find whether a particular checkbox is checked using the 
isChecked ( ) method. It returns true if the checkbox is checked: 



CheckBox checkbox = (CheckBox) findViewByld(R.id•checkbox 
boolean checked = checkbox.isChecked(); 
if (checked) { 

//do something 


an droid, view. View 


△ 


android.widget.TextView 


△ 


android.widget.Button 




android.widget. 

CompoundButton 


7 \ 


android.widget.CheckBox 


milk); 
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Checkboxes (continued) 


Just like buttons, you can respond to the user clicking a checkbox by using 
the android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 


<CheckBox android : id= M @ + id/checkbox—milk" 


android : layout_width= M wrap_content" 
android : layout—height= n wrap—content n 
android : text= n @ string/milk" 


android:onClick= M onCheckboxClicked"/> ^ 

<CheckBox android : id 二 " @+id/checkbox_sugar" 
android : layout—width=' ， wrap—content，' 
android : layout 一 height= n wrap—content n 
android : text="@ string/sugar" 

android:onClick= M onCheckboxClicked"/> 


this case, ihc o^Chcdkbo^Cli^kcdO 

你 e 七 hod will jci called r\o wttev* 
yjW\C\) dhcdkboy. acts c\\cYt&- Wc 
^ould have spedi-fied a 

method (o>r eddh i-f ^jtd 

v/a 灼七 ed "to. 


You then define the method in your activity like this: 

public void onCheckboxClicked(View view) { 

// Has the checkbox that was clicked been checked? 
boolean checked = ((CheckBox) view).isChecked(); 


// Retrieve which checkbox was clicked 
switch(view•getld()) { 

case R.id.checkbox_milk: 
if (checked) 

// Milky coffee 

else 

// Black as the midnight sky on a moonless night 
break; 

case R.id.checkbox_sugar : 
if (checked) 

// Sweet 

else 

// Keep it bitter 
break; 
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radio ibi/ftons 


Radio buttons 


These let you display multiple options to the user. The user can select a single 
option. 

Use \rdd'io butto ⑽ *to 
vcs*tv*id*t users cMo\tt 
*to jus*t or>c option• 

Pefiwiwg them w XML 

You start by defining a radio group, a special type of view group, using the 
<RadioGroup> tag. Within this, you then define individual radio buttons 
using the <RadioButton> tag: 



<RadioGroup android:id="@+id/radio_group" 
android:layout—width="match—parent" 
android:layout—height= n wrap—content" 


android:orientation="vertical n > 



You da 灼 dhoosc "to 

display -the \radio 

butto 灼 s a hovizjohtal 

o\r vc\rtidal list 


<RadioButton android : id= M @+id/radio_cavemen" 
android:layout_width="wrap_content" 
android:layout 一 height= n wrap_content n 
android:text="@string/cavemen" / > 


<RadioButton android : id= n @+id/radio—astronauts 
android:layout_width= M wrap_content" 
android:layout_height="wrap_content" 
android:text= M @string/astronauts" / > 
</RadioGroup> 



Using them iw your activity code 

You can find which radio button is selected using the 
getCheckedRadioButtonld () method: 

RadioGroup radioGroup = (RadioGroup) findViewByld(R.id•radioGroup); 
int id = radioGroup.getCheckedRadioButtonld(); 
if (id == -1){ 

//no item selected 

} 

else { 

RadioButton radioButton = findViewByld(id); 
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Radio buttons (contmued) 

You can respond to the user clicking a radio button by using the 
android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

<RadioGroup android : id= M @+id/radio_group" 
android:layout_width= M match_parent" 
android:layout—height= n wrap_content n 
android:orientation= M vertical"> 

<RadioButton android : id="@+id/radio_cavemen" 
android: layout—width= ， 'wrap—content n 
android: layout—height= n wrap_content，' 
android:text="@string/cavemen" 

android:onClick= n onRadioButtonClicked M /> 

<RadioButton android : id="@+id/radio—astronauts 
android:layout_width= n wrap_content" 
android: layout—height= n wrap_content ，， 
android:text="@string/astronauts M 

android:onClick= n onRadioButtonClicked M /> 

</RadioGroup> 


Tke radio group 
containing tke 
radio buttons 
is a subclass ol 


LinearLayout. 
You can use tke 
same attributes 
witk a ractio 
group as you can 
witk a linear 
layout. 


You then define the method in your activity like this: 

public void onRadioButtonClicked(View view) { 

RadioGroup radioGroup = (RadioGroup) findViewByld(R•id•radioGroup); 
int id = radioGroup.getCheckedRadioButtonld(); 
switch(id) { 

case R.id.radio_cavemen : 

// Cavemen win 
break; 

case R.id.radio_astronauts : 

// Astronauts win 
break; 
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spinners 


Spi_r 


As you’ve already seen, a spinner gives you a drop-down list of values 
from which only one can be selected. 


Wc saw spiirmems 

ba^k Chap-tcv- Z. — ^ 


Pefinmg it w XML 



You define a spinner in XML using the <Spinner> element. 

You add a static array of entries to the spinner by using the 
android : entries attribute and setting it to an array of strings. 


<Spinner 

android:id= M @ + id/spinner" 

android: layout—width= ，， wrap_content，' 




TV>cv-c av-c o*thcv >ways 
Jk 七 V>c 

spm^cv-, v/hidii you II 
sec m book. 


android:layout_height= M wrap_content" 


android:entries= M @array/spinner_values" / > 


You can add an array of strings to strings.xml like this: 

〈 string-array name="spinner_values"> 

<item>light</item> 

<item>amber</item> 

<item>brown</item> 

<item>dark</item> 

</string-array> 

Using it w your activity code 

You can get the value of the currently selected item by using the 
getSelectedltem () method and converting it to a String: 

Spinner spinner = (Spinner) findViewByld(R•id•spinner); 

String string = String•valueOf(spinner•getSelectedltem()); 


an droid, view. View 


△ 


android.view.ViewGroup 


△ 


android.widget. 

AdapterView 


△ 


android.widget. 

AbsSpinner 


ZX 


android.widget.Spinner 
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Image views 


You use an image view to display an image: 


viev/ 

doy>*t3ms By\ 


客 tarfewzi 

MTCoffee 


Adding an image to your project 


android.view.View 

• • • 


/ 

\ 

android.widget.lmageView 

»«» 



个 


TKc |may\/*ic>w dass is a 
d*ivct*t subclass o( V'\c^i- 


You first need to add an image file to your project as a drawable 
resource. If you expand the app/sre/main/res folder in your project, 
you should see that there’s a folder called drawable. This is the default 
location for image resources. To add an image file to this folder, you 
simply drag the image file to it. 


If you want, you can use different image files depending on the screen 
density of the device. This means you can display higher-resolution 
images on higher-density screens, and lower-resolution images on lower- 
density screens. To do this, you create different drawable folders in aj 
sre/main/res for the different screen densities. The name of the folder 
relates to the screen density of the device: 


You tv-ca*tc a -foldcv- bv *to 

Project view o*f Voiav- -roldcv- 

W—l 吵右吒 W \o\dcr t a^d ^oosmj 

pile, New..., A^d^roid resource 


android-ldpi 

android-mdpi 


android-hdpi 


android-xhdpi 


Low-density screens, around 120 dpi. 
Medium-density screens, around 160 dpi. 
High-density screens, around 240 dpi. 
Extra-high-density screens, around 320 dpi. 


oy\ v/hai vc\rsior> o( 
A^dv*oid Studio you’ve -the 

IDE may dv-ca-tc some o( -these 

-Poldcvs (or you auWdiiddlly- 


android-xxhdpi Extra-extra-high-density screens, around 480 dpi. 

android-xxxhdpi Extra-extra-extra high-density screens, around 640 

dpi. 

You then put different resolution images in each of the drawable^ folders, 
making sure that each of the image files has the same name. Android 
decides which image to use at runtime, depending on the screen density 
of the device it’s running on. As an example, if the device has an extra 
high density screen, it will use the image located in the draw able-xhdpi 
folder. 


If an image is added to just one of the folders, Android will use the 
same image file for all devices. It’s common to use the drawable folder for 
this purpose. 
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Images: the layout XML 

You define an image view in XML using the <ImageView> element. 

You use the android : src attribute to specify what image you want to 
display. You use the android : con tent Description attribute to 
add a string description of the image so that your app is more accessible: 

<ImageView 

android : layout—width=，'2 0Odp" 
android : layout_height="100dp" 

android:src= n @drawable/starbuzz_logo M 

android: con ten tDe scrip tion= @ s tring/s tarbuz z_logo ▼▼ 

The android : src attribute takes a value of the form n @drawable/ 
image_name n , where image_name is the name of the image 
(without its extension). Image resources are prefixed with @drawable. 
@drawable tells Android that it’s an image resource located in one or 
more of the drawable folders. 


Using it w your activity code 

You can set the image source and description in your activity code using 
thesetlmageResource() andsetContentDescription() 
methods: 

ImageView photo = (ImageView) findViewByld(R. id.photo); 
int image = R.drawable•starbuzz 一 logo; 

String description = "This is the logo"; 

photo.setlmageResource(image); 

photo.setContentDescription(description); 


This code looks for the image resource called starbuzz_logo in the 
drawable^ folders, and sets it as the source of an image view with an ID 
of photo. When you need to refer to an image resource in your activity 
code, you use R. drawable . image_name where 
image_name is the name of the image (without its extension) 
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Adding images to buttons 

In addition to displaying images in image views, you can also display 
images on buttons. 

Pisplaying text and m image on a button 

To display text on a button with an image to the right of it, use the 
android : drawableRight attribute and specify the image to be 
used: 


<Button 

android:layout—width= n wrap—content n 
android:layout_height= n wrap_content" 《 

android : drawableRight:’▼ @drawable/android n 

android:text= M @string/click_me" / > 

If you want to display the image on the left, use the 
android : drawableLef t attribute: 


P'tsflay android imay v-csouv-dc 

Side o-f butfem. 


OY\ 



<Button 

android:layout 一 width= n wrap_content n 
android:layout_height= n wrap_content" 

android : drawableLeft= n @drawable/android M 

android:text= M @string/click_me" / > 

Use the android : drawableBottom attribute to display the image 
underneath the text: 



<Button 

android:layout_width= M wrap_content" 
android:layout_height= n wrap_content" 

android : drawableBottom: n @ drawable/android" 

android:text= M @string/click_me" / > 

The android : drawableBottom attribute displays the image above 
the text: 



<Button 

android:layout—width= n wrap—content n 
android:layout 一 height= n wrap_content n 

android : drawableTop= n @ drawable/android" 

android:text="@string/click_me" / > 
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image buttons 


Image Puttow 

An image button is just like a button, except it contains an 
image and no text. 


Pefinmg it w XML 

You define an image button in XML using the <ImageButton> 
element. You use the android : src attribute to say what image you 
want the image button to display: 



<ImageButton 

android:id="0+id/button" 
android:layout_width="wrap_content" 
android:layout—height= n wrap_content n 
android:src= M @drawable/button_icon / > 

Using it w your activity code 

You get the image button to respond to the user clicking it by using the 
android : onClick attribute in the layout XML, and setting it to the 
name of the method you want to call in your activity code: 

android : onClick= M onButtonClicked" 



令 


TV^c tlass 

^oi Butbw <^lass. Poes 
suv-pv-*isc you? 


You then define the method in your activity like this: 

/** Called when the image button is clicked */ 
public void onButtonClicked(View view) { 

// Do something in response to button click 



Layout 


o 

Activity 
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Scroll views 


12:25 


If you add lots of views to your layouts, you may have problems on 
devices with smaller screens — most layouts don’t come with scrollbars 
to allow you to scroll down the page. As an example, when we added 
seven large buttons to a linear layout, we couldn’t see all of them. 



To add a vertical scrollbar to your layout, you surround your existing 
layout with a <ScrollView> element like this: 


<ScrollView xmlns : android: n http://schemas.android.com/apk/res/android" 
xmlns : tools= n http : //schemas.android.com/tools" 

android:layout_width= M match_parent" 
android:layout height="match parent" 


Alovc 



ttv-ibu-tcs -Pv-orw -the 


layou-t -to the <Sdv-olH/icw> as the 

tools :context=» .MainActivity" >^< - <S^olll/iew> is the ,oot 


<LinearLayout 

android:layout—width= n match—parent n 
android:layout—height= n match—parent” 
android:paddingBottom= n 16dp" 
android:paddingLeft= M 16dp" 
android:paddingRight="16dp" 
android:paddingTop="16 dp" 
android:orientation= M vertical" > 


</LinearLayout> 

</ScrollView> 

To add a horizontal scrollbar to your layout, wrap your existing 
layout inside a <HorizontalScrollView> element instead. 


1^1 

■ ■ 

1^1 


ouv layout m a 
<Sd\roll\/icv/> v^as added a 

SdV"ollb3V". TilC usev* tBY\ 
*to dll o-f views. 




you are here ► 219 




















toasfs pop up 


Toasts 


There’s one final widget we want to show you in this chapter: a 
toast. A toast is a simple pop-up message you can display on the 
screen. 

Toasts are purely informative, as the user can’t interact with them. 
While a toast is displayed, the activity stays visible and interactive. 
The toast automatically disappears when it times out. 

Using it w your activity code 

You create a toast using activity code only. You can't define one in 
your layout. 


To create a toast, you call the Toast. makeText () method, and 
pass it three parameters: a Context (usually this for the current 
activity), a CharSequence that’s the message you want to display, 
and an int duration. Once you’ve created the toast, you call its 
show () method to display it. 


java.Iang.Object 

參 • • 


/ 

\ 

android.widget.Toast 

參 • • 



Toast \^i actually a 
-tyfc <^c \/'icy/. TiicyVc a 
useful y/ay o-f jWrnj 七 he 
user a sKov*b message) 

so v/cVc s^cak'mj i*t 

*m*to tWis 乩外 ter. 


Here’s the code you would use to create a toast that appears on 
screen for a short duration: 

CharSequence text = "Hello, 工 ， m a Toast !，'； 
int duration = Toast•LENGTH—SHORT; 

Toast toast = Toast.makeText(this, text, duration); 
toast.show(); 
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It's time for you to try out some of the views we've introduced you to this chapter. Create a 
layout that will create this screen: 


☆ia probably y/or\’*t y/3ir\*b *to 

Codt but v/Viy y^oi cf •州 

I 阳 v 
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solution 



Here's one of the many ways in which you can create the layout. Don't worry if your code looks 
different, as there are many different solutions. 


<^\ridLayou*t / sdhc^as.ahdroid ^om/apk/res/andhroid” 

y.nr\lhS：-(jools=- ，， h*t*tp : / / sdhd^as.ahdv-oiddom/ *tools^ , 

ahdroid:l 平 ^ ToldZlt 5a U a Vdatwc 

ahdhroid : layou*t— layout ms-tcad- 
ar\dv"oid : paddm3Bottow' =1 ”l 厶 dp” 

如 droidhpaddmgLrf 厶 dp” 


ahdv-oid^addmgRiglit—^>dp’ 
ahdroid ： padd*m3Top=- ,, l i>d^ 
3hdvoi d :dol umhCourrt: 1 ” 2* W 


lA/fell use *tv/o dolunrms. 


<U\/ie>w 

ahdhroid:layou*t_wid*th 二 "wrap_dorrterrt” 
ahdhroid : laYou*t_heigh 七二 ” y/\rap_6orrterrt” 

如 droi(l%ou 七一 row 二 ” 0 :: ” p isp |ay a V.cv/ at -to f tV,at s P a,s botV, 〜 Uw 

dhd v-oi d ： layout^ol O l) 

dhd v*oi d: la you*t_dol umrmSpa h 二 " 2*" 

ahdroid^c^-t—^^s-tv'mg / message^ / > ^^All of the views heed stvihgs -to 

be sdded -fco s-tHhgs.xml. 

<U\/iew 

ay\dhroid : laYou*t_wid*th 二 "wrap_dorrteh*t” 
ar\dv*oid : layou 七一 hebM^’wrap 一 dorrterrt” 
ahdroid ： layou*t - row=- , ， l ;， - Add a tcw>pcv-a*tuv-c label *to 

如 droidhlaYout 一仏 1 嶋二 ”0” do1 叫 

a^dv-oidr>j / /> 
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<7o^lcBu*t*b>h 

ahdroid ： layout_width =1 ，， w\rap -- doh*tch*t ， 
andvoi d: la yout—hei# 七二 ” wrap_6oh*teh 七 
ahdv-oidi ： layou*t - jrow= i ， ; l ,l 
ay\dhroid : laYou*t_dolunrm 二 ”1 ” 
ahdhroid:*twt 仏二”沴 sfcrnr^/ho*t” 
ahdvoid : *te>^U) 仰二 ” 渙 s*brnr^/ told^ /> 

<ChcdkBox. a^dv-oid^id—^^+id/dhcdkbox^milk 
ahdroid ： layout_width—^wv-ap^doh-tch-t 
a^dv-oi d ： layout^Kci^h't—^wrap^oh-tch-t 
a^dv-oi d ： layou-t^jrow—^Z^ 
dhdv*oidi ： Uyou*t — ^ol unrm ： =^0” 
ahdv , oid : *tc%*t := - ，， ®s*tv , m3 / nr\ilk W /> 

<ChcdkBo% andvoidhid? 诊 +id/dhcdkboy^_su^ar 
ar\dv-oid ： layout_width—^wrap^oh-tch-t 
andvoi d: la yout—hei# 七二 ” wrap_doh*teh 七 
ar\dv-oi d ： layou*t - jrow= 1， ^ W 
d hd v*oi d: layout^ol unrm: w 0" 
ahdv , oid ： *tcx.*t =1 ，， ®s*tv , m5 / su^a\r ，； /> 



<ChedkBox. ahd\roid ： id- ； @+id/dhcdkbo%Jemo^ used a dhcdkbo^c (or ca^h o( -the 


ahdbroid : laYou*t_wid*th= 1 "w\rap_6oh*terrt 
andvoi d: la 七二 ”w\rap_doh*teh*t 

d: la You*t_jrow 二 " 午 ” 
d hd v*oi d: layou*t — ^ol unrm: w 0" 
andvoidhteyb 11 ” 沴 s*t\rnr^/lemoh” /> 


values (AliIk, 3^d Lcrwo^). Wc 

pu*t cadh ov\t oy\ a scpav-aic vow. 


</^vidLayou*b> 
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yet another solution 



Layout Magnets Solution 

We wrote some code to center the Send button in the third row of 
the grid layout, but a sudden breeze blew some of it away. See if you 
can reconstruct the code using the magnets below. 

<GridLayout...> 


<TextView... /> 
<EditText.../> 
<EditText.../> 



These av-c 七 he views already added- 


<Button 

android : layout—width= n wrap_content n 
android : layout—height= n wrap_content，' 


android : layout row: 


android : layout column 


android : layout gravity: 


android : layout columnSpan^ 



The button siav-is a*t royj Z, dolumy> O. 


I/Ve "to dejrtev* ’rt hov-izo^-t^lly. 



LzD 


'I 七 spans *tv/o dolunrms. 


android : text= M @string/send" / > 


</GridLayout> 


Column 

0 


Column 

1 


Row 2 — > 



L J 

/ 



Send 




Column span = 2 


Yo\a didn't y\tt& *to 
use -these ma^cts. 


^ L ，on l 


n i n I I :i 
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Your Android Toolbox 

You’ve got Chapter 5 under 
your belt and now you’ve 
added views and view groups 
to your toolbox. 




BULLET POINTS 


■ 


■ 


GUI components are all types of 
view. They are all subclasses of the 

android. view. View class. 

All layouts are subclasses of the 
android. view. ViewGroup class. 
A view group is a type of view that can 
contain multiple views. 

■ The layout XML file gets converted to a 
ViewGroup containing a hierarchical tree 
of views. 


■ 


■ 


■ 


■ 


A relative layout displays child views 
relative to other views, or relative to the 
parent layout. 

A linear layout lists views either 
horizontally or vertically. You 
specify the direction using the 

android : orientation attribute. 

A grid layout divides the screen into a 
grid of cells so that you can specify which 
cell (or cells) each view should occupy. 
Use android : columnCount to 
say how many columns there should 
be. Use android : layout_row 
and android : layout—column 
to say which cell you want each view to 
appear in. Use android : layout— 
columnSpan to say how many 
columns the view should spread across. 

Use android: padding* attributes 
to specify how much padding you want 
there to be around a view. 


Use android : layout—weight in 

a linear layout if you want a view to use up 
extra space in the layout. 

android : layout_gravity lets 
you say where you want views to appear 
in their available space. 

android : gravity lets you say 
where you want the contents to appear 
inside the view. 

<ToggleButton> defines a toggle 
button which allows you to choose 
between two states by clicking a button. 

〈 Switch 〉 defines a switch control that 
behaves in the same way as a toggle 
button. It requires API level 14 or above. 

<CheckBox> defines a checkbox. 

To define a group of radio buttons, 
first use <RadioGroup>to define 
the radio group. Then put individual 
radio buttons in the radio group using 

<RadioButton>. 

Use <imageview> to display an 
image. 

<imageButton> defines a button with 
no text, just an image. 

Add scrollbars using <Scrollview> 
or <HorizontalScrollView>. 

A Toast is a pop-up message. 


CHAPTER 5 
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6 l!st Views and adapters 




參 Getting Organized 





Sheesh! So many 
ideas... However will I turn 
all of these into the most 
downloaded app of the year? 


Want to know how best to structure your Android app? 

You’ve learned about some of the basic building blocks that are used to build apps, and 
now it’s time to get organized. In this chapter, we’ll show you how you can take a bunch 
of ideas and structure them into an awesome app. We ll show you how lists of data 
can form the core part of your app design, and how linking them together can create a 
powerful and easy-to-use app. Along the way, you’ll get your first glimpse of using event 
listeners and adapters to make your app more dynamic. 


this is a new chapter 
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ideas 


Every app starts with ideas 

When you first come up with an idea for an app, you’ll have 
lots of thoughts about what the app should contain. 

As an example, the guys at Starbuzz want a new app to 
entice more customers to their stores. These are some of the 
ideas they came up with for what the app should include: 


⑽紗漱 & 

\ •八 V4 

e^( 


冰 play a menu 
^>hou)in^ q|| 
•^oodyou can 

buy. 


ShOuO 8 \\St 6\\ 

our stores. 


: a Us-t 
: he drir 


inKs uoe 


se\\. 


-the 

address and 


opening iimes o-? 
ea ^h siore. 



sV^ou) o， 

an aeon ^ 00( ^ 



Display a s-tar-t 

screen uoi 七 h 3 

Ust op 七 ions. 




These are all ideas that users of the app will find useful. 
But how do you take all of these ideas and organize them 
into an intuitive, well-organized app? 
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Categorize your ideas: 

top-level, category, and detail/edit activities 

A useful way to bring order to these ideas is to categorize 
them into three different types of activity: top-level 
activities, category activities, and detail/edit activities. 


Top-level activities 

A top-level activity contains the things that are most 
important to the user, and gives them an easy way of 
navigating to them. In most apps, the first activity the 
user sees will be a top-level activity. 


Display 8 
s-tar-t screen 
u)\-th a Us-t 1 
op 七 ions. 


Category activities 

Category activities show the data that belongs to a 
particular category, often in a list. These type of activities 
are often used to help the user navigate to detail/edit 
activities. An example of a category activity is a list of all 
the drinks available at Starbuzz. 


Shouo 8 \\St O^r 


display 

a\\ our stores. 


3 menu 



shotoin^ all 
士 he -^oocl uou 
c^n buy. 

Display a Us 七 
o 吴 -the drinKs 
uoe se\\. 

_ — 




Petail/edit activities 

Detail/edit activities display details for a particular 
record, let the user edit the record, or allow the user to 
enter new records. An example of a detail/edit activity 
would be an activity that shows the user the details of a 
particular drink. 


Once you’ve categorized your activities, you can use 
them to construct a hierarchy showing how the user will 
navigate between activities. 



vtero 

异 00& 


冰 play ihe 

address 

openinn 
■times o-? J 

ea ^h store. 



Think of an app you'd like to create. What activities should it include? Organize these activities 
into top-level activities, category activities, and detail/edit activities. 
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organize your ideas 


Navigating through the activities 

When you categorize the ideas you have into top-level, category, 
and detail/edit activities, you can use these categorizations to 
figure out how to navigate through your app. In general, you 
want your users to navigate from top-level activities to detail/ 
edit activities via category activities. 


Top-level activities go at 
the top 

These are the activities your user 
will encounter first, so they go at 
the top. 


Category activities go 
between top-level and 
detail/edit activities 

Your users will navigate from the 
top-level activity to the category 
activities. In complex apps, you 
might have several layers of 
categories and subcategories. 


Display 8 \\s-t 
o^r ihe drinks 
uoe seU. 


Display a 
s-tar-t screen 
uoi-th a Us 七 o 妥 

op-tions. 


/ J 

/ 

\ 

Display 

Shouo a Us>*t o; 

a menu 

a\\ our stores. 

shouoino^ aU 


-the ^oodyou 


can buy. 



Petail/edit activities 

These form the bottom layer 
of the activity hierarchy. Users 
will navigate to these from the 
category activities. 


Shouo de-ta\\s 
o 妥 each 
drinK. 


Shouo de-tai\s 
o^- an i 七 em o; 
妥 cod 


Display -the 
address 
and opening 
•tirnes o 妥 
each s-tore. 


As an example, suppose a user wanted to look at details of one 
of the drinks that Starbuzz serves. To do this, she would launch 
the app, and be presented with the top-level activity start screen 
showing her a list of options. The user would click on the option 
to display a list of drinks. To see details of a particular drink, she 
would then click on her drink of choice from the list. 
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Use ListVicws to wavigate to data 

When you structure your app in this way, you need a way of navigating 
between your activities. A common approach used in this situation is to 
use list views. A list view allows you to display a list of data that you 
can then use to navigate through the app. 


As an example, on the previous page, we said we’d have a category 
activity that displays a list of the drinks sold by Starbuzz. Here’s what 
the activity might look like: 


TWis is a UsWiom 

to 灼 • 灼 … 3 a of drmks. 


10:26 




Latte 


Cappuccino 


Filter 



The activity uses a list view to display all the drinks that are sold by 
Starbuzz. To navigate to a particular drink, the user clicks on one of 
the drinks, and the details of that drink are displayed. 


l-f you dlidk ov\ -the Latte - 
option \y\ -the Lis-tl/icw, you 
get shovm ihc details -Pov- 
the La-t-tc- 



We’re going to spend the rest of this chapter showing you how to use 
list views to implement this approach using the Starbuzz app as an 
example. 
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welcome to starbuzz 


part of 

WcYc goihg to build the Starbuzz app 


Rather than build all the category and detail/edit activities required 
for the entire Starbuzz app, we’re going to focus on just the 
drinks. We’re going to build a top-level activity that the user will 
see when they launch the app, a category activity that will display a 
list of drinks, and a detail/edit activity that will display details of a 
single drink. 


The top-level activity 

When the user launches the app, she will 
be presented with the top-level activity, the 
main entry point of the app. This activity 
includes an image of the Starbuzz logo, and a 
navigational list containing entries for Drinks, 
Food, and Stores. 


When the user clicks on an item in the list, the 
app uses her selection to navigate to a separate 
activity. As an example, if the user clicks 
on Drinks, the app starts a category activity 
relating to drinks. 


10:26 


Starlbuzz 

暫 Coffee 


Drinks \ 

I _ 

Food 

1 _ j 

1 


Stores 


The S*tav-buzz. \oy>, a^d 
a 1 is 七 of options. Wlc’ll 


*0^ IVmks 

option. 



The drinks category activity 

This activity is launched when the user chooses 
Drinks from the navigational list in the top- 
level activity. The activity displays a list of all 
the drinks that are available at Starbuzz. The 
user can click on one of these drinks to see 
more details of it. 
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The drink detail activity 

The drink activity is launched when the user 
clicks on one of the drinks listed by the drink 
category activity. 

This activity displays details of the drink the 
user has selected, such as its name, an image 
of what it looks like, and a desciption. 



How the user navigates through the app 


The user navigates from the top-level activity to the drink category 
activity by clicking on the “Drinks” item in the top-level activity. She 
then navigates to the drink activity by clicking on a drink. 


10:26 


WfCofftt. 


Drinks 


Food 


Stores 


The usev* tl'itks oir\ 
七 Pvmks 
ay>d this displays a 
list of dv*mks. 



10:26 


Latte 

Cappuccino 
Filter 


l/Vhch -the usc\r 

dlidks ov\ a dvi^k, 

七 ha 七 d\rmk is "the 灼 

displayed. 




: ilter 

Highest quality beans roasted and brewed fresh 
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app structure 


The Starbuzz app structure 

The app contains three activities. TopLevelActivity is the app’s 
top-level activity and allows the user to navigate through the app. 
DrinkCategoryActivity is a category activity; it contains a list of 
all the drinks. The third activity, DrinkActivity, displays details of a 
given drink. 

For now, we’re going to hold the drink data in a Java class. In a later 
chapter, we’re going to move it into a database, but for now we want 
to focus on building the rest of the app without teaching you about 
databases too. 


o 

o 

o 

o 

o 


When the app gets launched, it starts activity TopLevelActivity. 

The activity uses layout activity_top_ level, xml. The activity displays a list of 
options for Drinks, Food, and Stores. 


The user clicks on Drinks in T opLevel Act ivity. 

This launches activity DrinkCategoryActivity. This activity displays a < ’ 

list of drinks. 

Details of the drinks are held in the Drink.java class file. 


Pv-mkCa-tc^ov-yA^t^^y 

docs^*t v\ttA you *to 
dvea 七 e a layout -fov *rt- 
You II sec >why U*tcv- *m 
•the dKaftcv-. 


DrinkCategoryActivity gets the values for its list of drinks from this 
class. 


The user clicks on a drink in DrinkCategoryActivity. 

This launches activity DrinkActivity. The activity uses layout activity_drink. 
xml. 


DrinkActivity gets details of the drink from the Drink.java class 
file. 





</Lavout 


activity—top—level.xml 


TopLevelActivity.java 


DrinkCategoryActivity.java 


DrinkActivity.java 


l/Vhy does: 七七 his 
a^iivi-ty a 
layou-t? You’ll 
ou-t why laic\r. 


Drink.java 

⑩ / 


activity—drink.xml 


</Layou- 
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Here arc the steps 

There are a number of steps we’ll go through to build the app: 



Add the Drink class and image resources. 

The class contains details of the available drinks, 
and we’ll use images of the drinks and Starbuzz 
logo in the app. 



❺ 

o 

o 


Create TopLevelActivity and its layout. 

This is the entry point for the app. It needs to display 
the Starbuzz logo and include a navigational list of 
options. TopLevel Activity needs to launch 
DrinkCategoryActivity when the Drink option is clicked. 


Create DrinkCategoryActivity. 

DrinkCategoryActivity contains a list of all the 
drinks that are available. When a drink is clicked, it needs 
to launch DrinkCategory. 


Create DrinkActivity and its layout. 

DrinkActivity displays details of the drink the 
user clicked on in DrinkCategoryActivity. 



Create the project 

You create the project for the app in exactly the same way you did 
for the previous chapters. 


Create a new Android project for an application named 
“Starbuzz” with a package name of com . hfad. starbuzz. The 
minimum SDK should be API 15. You’ll need an activity called 
“TopLevelActivity” and a layout called “activity—top_level”. 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 
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Drink class 


The Vmk class 

We’ll start by adding the Drink class to the app. Drink.java is a pure Java class 
file that activities will get their drink data from. The class defines an array 



of three drinks, where each drink is composed of a name, description, and 


image resource ID. Add the class to the com. hfad.starbuzz package in the app/ 


sre/main/java folder in your project, giving it a class name of Drink. Then 
save your changes. 


Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


package com.hfad.starbuzz; 


pHhk has a dcsdviptioh, 

Ip. The \rcsou\rdc ID -to dHhk 
wc II add h> the fvojcdt oh the hext page. 


These av-c 
o-P 

the d\rihks. 

Well add 
these hCX-fc. 


public class Drink { 

private String name; 
private String description 
private int imageResourceId; 

dv-'mks IS dr^ av-v-ay D\rmks. 

//drinks is an array of Drinks |/S ， 
public static final Drink[] drinks = { 

new Drink("Latte", "A couple of espresso shots with steamed milk n , 
- drawable.latte), 


new Drink("Cappuccino", "Espresso, hot milk, and a steamed milk foam", 
— > R.drawable.cappuccino), 

new Drink("Filter", "Highest quality beans roasted and brewed fresh", 
R.drawable.filter) 

The Dmmk do^s-t\rud-tov 




//Each Drink has a name, description, and an image resource 
private Drink(String name , String description, int imageResourceId) { 

this.name = name; 
this.description = description; 
this.imageResourceId = imageResourceld; 


□ 


public String getDescription() { 

return description; 


Starbuzz 


public String getName() { 
return name; 



TKcsc ate ybtevs (or i\\t 
pvWa*tc vav-*iablcs. 


L Q 

app/sre/main 

' — I 


java 


public int getImageResourceId() { 
return imageResourceld; 


com. hfad. starbuzz 

Id 

Drink.java 


public String toString() {, ,, 

return this.name; 丁卜 

i or B IVmk is rts 灼 ame. 
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list views and adapters 


The image files 


The Drink code includes three image resources for its drinks with 
ids of R. drawable . latte, R. drawable . cappuccino 
and R. drawable . filter. These are so we can show the user 


images of the drinks. R. drawable . latte refers to an image 
file called latte : R. drawable . cappuccino refers to an image 
file called cappuccino, and R. drawable . filter refers to a file 
called filter. 


We need to add these image files to the project, along with an 
image of the Starbuzz logo so that we can use it in our top-level 
activity. To do this, download the files starbuzz-logo.png, cappuccino. 
png : filter.png, and latte.png from https://tinyurl.com/HeadFirstAndroid. 
Then drag the file to the app/sre/main/res/drawable folder in your 
Starbuzz project. 


When you add images to your apps, you need to decide whether to 
display different images for different density screens. In our case, 
we’re going to use the same resolution image irrespective of screen 
density, so we’ve put a single copy of the images in one folder. If 
you decide to cater for different screen densities in your own apps, 
put images for the different screen densities in the appropriate 
drawable^ as described in Chapter 5. 


Hcvc av-c -fouv imay -f iles. You add 

h^dro\A Studio by 
*to dv*a>w3blc -foldcv. 


app 

D build 
tllibs 
D sre 

► D arhdmtdTest 


Djava 
Cig res 

▼ El drawable 

j cappuccino.png 
圍 filter.png 
X a latte.png 

is starbuzzJogo.png 


When you save images to your project, Android assigns each 
of them an ID in the form R. drawable . image_name. As 
an example, the file latte.png is given an ID of R. drawable . 
latte, which matches the value of the latte’s image resource ID 
in the Drink class. 



name ： "Latte" 


description ： "A couple of expresso 
shots with steamed milk" 


imageResourceld ： R.drawable.latte 



Drink 


Now that we’ve added the Drink class and image 
resources to the project, let’s work on the activities. We’ll 
start with the top-level activity. 


T\\t 

•is IP 

R.dva>wablc.la*t*tc- 



R.drawable.latte 
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TopLevelActivity 


The top-level layout contams 
aw image and a list 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


When we created our project, we called our default activity 
Top Lev elAc tivity.jav a ， and its layout activity_ top_ level xml. We need to 
change the layout so it displays an image and a list. 


This is -the S-tavbuzz. lo^o- 

Wlc ddded "this "to ，— ^ 

pv-ojedi oy \ -the previous page. 


A s*ta*t*id options 


l * 

Wji Q io ：08 

Starbuzz 

參 

參 

• 



ttTCoffec 


Drinks 


Food 


Stores 





You saw how to display images in Chapter 5 using an image view. In 
this case, we need an image view that displays the Starbuzz logo, so 
we’ll create one that uses starbuzz_logo.png as its source. 

Here’s the code to define the image view in the layout: 


<ImageView 

« nese 3v*c the dimensions wc 

android: layout 一 width=”200d P ” ^ 如七七 {o have. 

android: layout—heights 100dp n > sou^rdc i\)t is i\\t siairbuz^Jo^o.^^ 

android: src= n @drawable/starbuzz_logo n ^~" -file >wc added b> 

android: contentDescription= n @string/starbuzz 一 logo” / > ^~~^ Addiv\^ 3 ^oy\icv\i dcsdv-ip-tioh 

•^akes youv app rwo\rc dddessible- 

When you use an image view in your app, you use the 
android : con tent Description attribute to add a description 
of the image; this makes your app more accessible. In our case, we’re 
using a string value of string/starbuzz—logo n . Add this to 

strings, xml: 


□ 


Starbuzz 


<resources> 


L Q 

app/sre/main 

~Z 3 


<string name= n starbuzz_logo n >Starbuzz logo</string> 

</resources 〉 


That’s everything we need to add the image to the layout, so let’s 
move on to the list. 


res 


413 

values 




strings.xml 
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list views and adapters 


Use a list view to display the list of options 


As we said earlier, a list view allows you to display a vertical list of data 
that you can then use to navigate through the app. We’re going to add a 
list view to the layout that displays the list of options, and later on we’ll 
use it to navigate to a different activity. 

Howto define a list view iw XML 

You add a list view to your layout using the <ListView> element. 

You then add an array of entries to the list view by using the 
android : entries attribute and setting it to an array of strings. The 
array of strings then gets displayed in the list view as a list of text views. 


Here’s how you add a list view to your layout that gets its values from an 
array of strings called options: 

〈ListView ^ —• 丁 iVis … cs 七 l.’s 七 v/iev/. 

android : id= n @+id/list 一 options” 
android : layout_width= M match_parent" 
android : layout_height= n wrap—content 
android : entries= n Qarray/options n /> 


The values \y\ 

"the I is 七 viev/ av-c 
dc-P*mcd by 七 he 
op-tio^s av-v-ay. 



You define the array in exactly the same way that you did earlier in the 


book, by adding it to strings.xml like this: 
<resources> 


<string-array name= n options n > 
<item>Drinks</item> 

<item>Food</item> 
<item>Stores</item> 
</string-array> 

</resources 〉 


□ 

Starbuzz 

L Q 

app/sre/main 


res 



val 


ues 




strings.xml 


This populates the list view with three values: Drinks, Food, and Stores. 


@array/options 




ListView 


Food 

Stores 


strings.xml 


The C>vbries aii\ribuic 
populaics -the L\siV'\t^ v/iih 
v ^lucs -Pvorw -the op-tio^s av-v-ay. 

rterw ’m 七 he List\/icv/ is 
d Tc^tl/icw. 
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layout code 


The full top-level layout code 

Here’s our layout code in full (make sure you change your code 
to match ours): 

<LinearLayout xmlns : android= M http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width= M match_parent" 

android: layout—height= n match 一 parent" WcVc d l 3 you*t B vcvtidal 

android:orientation= n vertical" ^ o\ricir>*t3tior>- TiVis y/ill display ouV" lis-t 

tools: context:” • TopLevelActivity" > d ••代七 he Siairbuz^ I050. 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


<ImageView 

android : layout 一 width= n 200dp n 
android : layout_height="10 Odp" 
android : src= '▼ @drawable/starbuzz_logo" 

android : contentDescription= n @string/starbuzz 一 logo” /> 
<ListView 

android : id= n @+id/list 一 options” 
android : layout_width= M match_^parent n 
android : layout_height= n wrap 一 content” 
android : entries="@array/options" /> 


□ 


Starbuzz 


app/sre/main 



layout 



activity— 

topjevel.xml 


</LinearLayout> 


K 
—— 

Test drive - 

Make sure you’ve applied all the changes to activity—top—lev el. xml ， 
and also updated strings.xml. When you run the app, you should 
see the Starbuzz logo displayed on the device screen with the 
list view underneath it. The list view displays the three values 
from the options array. 


If you click on any of the options in the list, nothing happens, 
as we haven’t told the list view to respond to clicks yet. The 
next thing we’ll do is see how you get list views to respond to 
clicks and launch a second activity. 
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list views and adapters 


fret ListVicws to respond to clicks with a Listcwcr 


You make the items in a list view respond to clicks by 
implementing an event listener. 

An event listener allows you to listen for events that take 
place in your app, such as when views get clicked, when 
they receive or lose the focus, or when the user presses a 
hardware key on their device. By implementing an event 
listener, you can tell when your user performs a particular 
action — such as clicking on an item in a list view — and 
respond to it. 

OnltemClickUsteHer listens for item clicks 


The Lisi\/icv/ v\ctds -to know 七 he 



The Usti/iow 七 ells 七 V>c 4a 扣 item 

yb disked so -the t^Y\ rtatb 


When you want to get items in a list view to respond to clicks, you 
need to create an OnltemClickListener and implement its 
onltemClick () method. The OnltemClickListener listens 
for when items are clicked, and the onl temClick () method 
lets you say how your activity should respond to the click. The 
onl temClick () method includes several parameters that you can 
use to find out which item was clicked, such as a reference to the view 
item that was clicked, its position in the list view (starting at 0)，and the 
row ID of the underlying data. 


We want to start DrinkCategoryActivity when the first 
item in the list view is clicked — the item at position 0. If the 
item at position 0 is clicked, we need to create an intent to start 
DrinkCategoryActivity. Here’s the code to create the listener: 


AdapterView.OnltemClickListener itemClickListener = new 


0^|*tcr»»ClifikListcir>C\r is 
a r>cs-tcd dldss y/i-th the 
Ad3p"tcv*\/icy/ dldss. Lis*t\/iev/ 
is a subclass o( Adap-tcv-\/icv/. 

AdapterView.OnltemClickListener(){ 


D\r’mks is 七 he rtdm 七 he 

list view, so its ai position O. 


public void onltemClick (AdapterView<?> listView, ^~ v 'iev/ v/3s dlidkcd 

View itemViewT^ •the lis 七 viev/). 

int position, jive you r^ovc about whWrte"as disked m -the 

long id) {lis-t view sudh as -the iicrw view i-ts position. 

(position == 0) { 

Intent intent = new Intent(TopLevelActivity.this , DrinkCategoryActivity.class); 

I 七 y\ctds bo lauMh 


if 


startActivity(intent); 


The *fvom 

"fofLcvclA^*t» v, *ty- 


D\r*mkC5icgo\ryA^iiviiy. 


Once you’ve created the listener, you need to add it to the ListView. 


you are here ► 


241 






setOnltemClickListenerQ 


Set the listener to the list view 

Once you’ve created the OnClickltemListener, you need 
to attach it to the list view. You do this using the ListView 
setOnltemClickListener () method. The method takes one 
argument, the listener itself: 





Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


AdapterView•OnltemClickListener itemClickListener = new AdapterView•OnltemClickListener(){ 
public void onltemClick(AdapterView<?> listView, 


ListView listView = (ListView) findViewByld(R.id.list 一 options); 
listView.setOnltemClickListener(itemClickListener) 

K 


Adding the listener to the list view is crucial, as it’s this step that makes the 
listener get notified when the user clicks on items in the list view. If you 
don’t do this, the items in your list view won’t be able to respond to clicks. 

You’ve now seen everything you need in order to get the 
TopLevelActivity list view to respond to clicks. 


This is *tV>c l*is*tcir>cv- y/c jus*t dvca*tcd- 


What happens when you run the code 



The onCreate() method in TopLevelActivity creates an 
OnltemClickListener and links it to the activity's ListView. 



O’ 

TopLevelActivity ListView 



OnltemClickListener 



When the user clicks on an item in the list view, the 
onltemCIickListeners onItemClick() method gets called. 

If the Drinks item is clicked, the OnltemClickListener creates an intent to start 
DrinkCategoryActivity. 



ListView 


OnltemClickListener 


DrinkCategoryActivity 
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The full TopLevdActivity code 

Here’s the complete code for TopLevelActivity . j ava. 
Replace the code the wizard created for you with the code below, 
then save your changes: 




list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


package com.hfad.starbuzz; 


□ 

Starbuzz 


import 

import 

import 

import 

import 

import 


public 


android.app.Activity; 
android.content.Intent; 
android.os.Bundle; 


HU 

app/sre/main 

^~r~i 

一 9 


android. widget. AdapterView ; 
android.widget.ListView; 
android.view.View; 



1/VeYe usmj -these classes. 


class TopLevelActivity extends Activity { 



com.hfad.starbuzz 



TopLevel 

Activity.java 


Cv-ca*tc lis 七 ew. 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_top—level); 

//Create an OnltemClickListener ^ 〆 

AdapterView.OnltemClickListener itemClickListener = 

new AdapterView.OnltemClickListener(){ 
public void onltemClick(AdapterView<?> listView, 

View v, 气 

int position, 
long id) { 

if (position == 0) { 

Intent intent = new Intent(TopLevelActivity.this, 

DrinkCategoryActivity.class); 


I 叫 >le 你 eivt its or)lieimCliM) mcihod- 


startActivity(intent); 


La^uir) D^mkCaie^o\ryAci\y/\iy i-f ihc 
usev tl'idks or) ihe Pv-*mks rtem. Well 
trtait 七 his adtiviiy SO Ao}n!i 

} i-f ^dyo\A Studio says *i*t docs^*t 

//Add the listener to the list view 

ListView listView = (ListView) findViewByld(R.id.list 一 options); 
listView. setOnltemClickListener (itemClickListener) ; lis-tc cv- *fco 

list view. 
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you are here 


Where we've got to 

So far we’ve added Drink.java to our app and created 
TopLevelActivity and its layout. 




Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


l/Vc added "this *Pi\rst 


‘ e 〆 seated ^ ^ 

TofLcvcIA^v'i-ty activity_top_levd.xml 

a 灼 d vb layout- 



Drink.java 


activity—drink.xml 



Device 


TopLevelActivity .java 


DrinkCategoryActivity.java 




DrinkActivity.java 


I/Vcll dvca*tc -this Y\t%b 


The next thing we need to do is create 
DrinkCategoryActivity so that it gets 
launched when the user clicks on the Drinks option in 
TopLevelActivity. 


th&reicire no 

Dumb Qv 


Questions 


Why did we have to create an event listener to get items 
in the ListView to respond to clicks? Couldn't we have 
just used its android : onClick attribute in the layout 
code? 


You can only use the android : onClick attribute 
in activity layouts for buttons, or any views that are subclasses of 
Button such as CheckBoxes and RadioButtons. 


The ListView class isn’t a subclass of Button, so using 
the android: onClick attribute won’t work. That’s why you 
have to implement your own listener. 
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list views and adapters 




Here's some activity code from a separate project. When the user clicks on an item in a list 
view, the code is meant to display the text of that item in a text view. Does the code do what it’s 
meant to? If not, why not? The text view has an ID of text—view and the list view has an ID 

of list view. 


package com.hfad.chO6_ex; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.AdapterView; 
import android.widget.ListView; 
import android.widget.TextView; 
import android.view.View; 

public class MainActivity extends Activity 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 

final TextView textView = (TextView) findViewByld(R•id•text_view); 
AdapterView•OnltemClickListener itemClickListener = 
new AdapterView•OnltemClickListener(){ 

public void onltemClick(AdapterView<?> listView, 

View v, 

int position, 

long id) { 

TextView item = (TextView) v; 
textView.setText(item.getText()); 

} 

}； 

ListView listView = (ListView) findViewByld(R•id•list_view); 
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exercise solution 



Here's some activity code from a separate project. When the user clicks on an item in a list 
view, the code is meant to display the text of that item in a text view. Does the code do what it’s 
meant to? If not, why not? The text view has an ID of text—view and the list view has an ID 

of list view. 


package com.hfad.chO6_ex; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget.AdapterView; 
import android.widget.ListView; 
import android.widget.TextView; 
import android.view.View; 

public class MainActivity extends Activity 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 

final TextView textView = (TextView) findViewByld(R•id•text_view) 
AdapterView•OnltemClickListener itemClickListener = 
new AdapterView•OnltemClickListener(){ 

public void onltemClick(AdapterView<?> listView, 

View v, 

int position, 

TWis is 如 'm *tV^c long id) { 

Lis*t\/>C>M dlis d ^- TextView item = (TextView) v; 

^ . 丄丁 £/) ^-^textView. setText (item. getText ()); 


y 七 its usmj ytTc^tO. 


ListView listView = (ListView) findViewByld(R•id•list view); 




The Code doesn't v/o\rk as 'm-behdedi ds l*mc o-f Code 
list\/icv/.sc*tOh|*tcr»»ClidkLis*tchCV-(i*tcr»\ClidkLis*tchC\r )； 
is missis -fvom o-f toAt- Apar 七 Code’s -f'me. 
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A category activity displays the data 
for a single category 

As we said earlier, DrinkCategoryActivity is an example of 
a category activity. A category activity is one that shows the data 
that belongs to a particular category, often in a list. You then use 
the category activity to navigate to details of the data. 

We’re going to use DrinkCategoryActivity to display a list 
of drinks. When the user clicks on one of the drinks, we’ll show 
them the details of that drink. 



list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


10:26 


10:26 




Drinks 


Food 


Stores 


l/VV>c^ usev dl'itks or\ 
-tlic pvmb rtem, adtiv*i*ty 
DvmkCa 七七… ••七 Y |S 
s*tav-*tcd- 



DvmkCaicjov-yA^iiviiy 
displays a lis 七 d dvmks. 

the usev dlidks ov\ a 
dy\v\\c, -that dv’mk is 七 hen 
displayed \y\ DvmkActivity. 





=ilter 

Highest quality beans roasted and brewed fresh 



To do this, we’ll create an activity containing a single list view 
that displays a list of all the drinks. As our activity only needs to 
contain a single list view with no other GUI components, we can 
use a special kind of activity called a list activity. So what’s a list 
activity? 
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ListActivity 


A ListActivity is aw activity 
that contains only a list 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


A list activity is type of activity that specializes in working with a list. It’s 
automatically bound to a list view，so you don’t need to create one yourself. 
Here’s what one looks like: 


^ list a 己七 Wrty 

o\ny\ list vicy/ so you 
do 灼’七 "to add >*t 

youv-scl-f. Vou still r\tt& 
-bo pvov'idc i*t 
ddia, and you II see 
iiov/ do soor\. 



10:26 


Latte 

Cappuccino 

Filter 



Lisifydiiviiy is a 
subclass o( Activity. 


android.app.Activity 


△ 


android.app.ListActivity 

getListView() 

onListltemClickO 


There are a couple of major advantages in using a list activity to display 
categories of data: 



You doiVt need to create your own layout. 

List activities define their own layout programmatically, so 
there’s no XML layout for you to create or maintain. The 
layout the list activity generates includes a single list view. You 
access this list view in your activity code using the list activity’s 
getListView () method. You need this to specify what data 
should be displayed in the list view. 



You doiVt have to implement your own event listener. 

The ListActivity class already implements an event listener 
that listens for when items in the list view are clicked. Instead of 


A ListActivity 
is a type oi 
Activity tkat 
specializes in 
working witk 

a List View. It 


creating your own event listener and binding it to the list view, you 
just need to implement the list activity’s onListI temClick () 
method. This makes it easier to get your activity to respond when 
the user clicks on items in the list view. You’ll see this in action 
later on when we use the onListltemClick () method to 
start another activity. 

Category activities generally need to display a single list view you can use 
to navigate to detail records, so list activities are good for this situation. 


kas a cteiault 
layout tkat 
contains tke 

ListView. 


So what does the list activity code look like? 


248 Chapter 6 















list views and adapters 


How to create a list activity 

Here’s what the basic code looks like to create a list activity. As you can see, it’s 
very similar to creating an activity. Use the New Activity wizard to create a new 
activity in your project called DrinkCategoryActivity, then replace the 
contents of DrinkCategoryActivity.jam with the code below: 


A^dv-oid Siudio may auWaiidally 

a layou-t -rile -Pov you. Wc 
wo " 七 use rt because lisi adiiviiics 
dc-p*mc ihciv ovm layou 七 . 


package com.hfad.starbuzz; 

import android. app. ListActivity; The 把七^七丫 *to C%*tcir>d 

import android, os .Bundle; Lis-tA^Wrty, y>o*t 


□ 


Starbuzz 


public class DrinkCategoryActivity extends ListActivity { 
@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 


L Q 

app/sre/main 


java 


com. hfad. starbuzz 

<liu 

DrinkCategory 

ListA^iiviiy mhe\rits 七 he o^C\rcaicO rweihod -Pv-om -the Activity.java 
A^ivi-ty dass. Wc\\ add toAt io -this meihod soon. 


The above code creates a basic list activity called 

DrinkCategoryActivity. Because it’s a list activity, it needs to extend 
the Lis tActivity class rather than Activity. 


The other difference is that you don’t need to use the setContentView () 
method to say what layout the list activity should use. This is because list 
activities define their own layouts so you don’t need to create one yourself. 

The list activity handles this for you. 

Just as with normal activities, list activities need to be registered in the 
AndroidManifest.xml file. This is so they can be used within your app. When you 
create your activity, Android Studio does this for you. 


〈application 
… > 

〈activity 

android: name=".To P LevelActivity" the (Wsi adivily wc 

android:label= M @string/app_name n 

Hcvc^s ad*bwi*by- 

w , . ■‘、 Evcvv needs ar\ 

</actlvlty> ^ 

〈activity * 

android : name=".DrinkCategoryActivity” 

android : label= n @string/title— activity 一 drink 一 category” > 
</activity> 

</application 〉 


Once you’ve created a list activity, you need to populate the list with data. 
Let’s see how. 


□ 

Starbuzz 


413 


app/sre/main 

AndroidManifest.xml 
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adapters 


android.-ehtries works for static array 
data held in striwgs.xml 

When we created our first activity TopLevelActivity, we could 
bind data to the list view using the android : entries attribute in 
our layout XML. This worked because the data was held as a static 
string array resource. The array was described in strings.xml, so we 
could easily refer to it using 

android : entries = M @array/options" 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


where options is the name of the string array. 

Using android : entries only works if the data is a static array 
in strings, xml. But what if it isn’t? What if the data is held in an array 
you’ve programmatically created in Java code, or held in a database? 
In this case, the android : entries attribute won’t work. 


If you need to bind your list view to data held in something other than 
a string array resource, you need to take a different approach; you need 
to write activity code to bind the data. In our case, we need to bind our 
list view to the drinks array in the Drink class. 


Ti^c list v*ic>m v>ccds 
*to be populated 

V/'l*tK dV"lir>ks did'td- 


The d\r’mk data 
needs "to dome 
-Pv-orw ihc dtmks 


avray 

D\r*mk 


’m 七 he 
dlass. 



ListView Drinkjava 


For wowstatic data, use an adapter 

If you need to display data in a list view that comes from a nonstatic 
source such as a Java array or database, you need to use an adapter. 
An adapter acts as a bridge between the data source and the list view: 


ListView 

> 


Adapter 

b 


Data 

一 Source 


l/Vc II use av\ avvay 
< — -fov ouv daia souvdc, 
bu*t >wc 州吵七 Kavc 
used a database or 
a v/eb scv-vidc- 



TKc adaftev- bvid^cs between lis*t 

viev/ a^d ike Aaia sou^rtc. Adapters alloy/ lisi 
viev/s bo display daia a variety so^tts. 


There are several different types of adapter. For now, we’re going to 
focus on array adapters. 
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list views and adapters 


Cowwcct list views to arrays with m array adapter 


An array adapter is a type of adapter that’s used to bind arrays to views. 
You can use it with any subclass of the AdapterView class, which means 
you can use it with both list views and spinners. 

In our case, we’re going to use an array adapter to display data from the 
Drink. drinks array in the list view. 


TiVis IS ouv lis 七 


I/Vell avray adapter -to 

bind ouv* list view "to ouv* 3v*v*3y. XKis is ouv* 

ir 


ListView 





Array 

Adapter 


Drink. 

drinks 


You use an array adapter by initializing the array adapter and attaching 
it to the list view. 

To initialize the array adapter, you first specify what type of data is 
contained in the array you want to bind to the list view. You then pass 
it three parameters: a Context (usually the current activity), a layout 
resource that specifies how to display each item in the array, and the 
array itself. 

Here’s the code to create an array adapter that displays Drink data 
from the Drink. drinks array: 


An adapter 
acts as a trictgfe 
between a View 
and a data 
source. An 
Array Adapter is 
a type oi adapter 
tkat specializes 
in working witk 
arrays. 




The avvay d 。 山 ms pvmk objects. 


ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink>( 

^this, 

android.R.layout.simple_list—item—l. 

Drink, dr inks) ; The avv-ay 


•this is tuvvcv>*t 

TKc M 七 ••吻 is a 

subdlass o( C 。 士乂七 . 


This is a buil 七一 m layout 
\rcsouv-tc- H 七 el Is 七 he av-v-ay 
adapic\r -to display eadh i-tem m 
"the av\ray d single 七以七 view. 


You then attach the array adapter to the list view using the ListView 
setAdapter () method: 


ListView listView = getListView(); 
listView. setAdapter (listAdapter); 


Behind the scenes, the array adapter takes each item in the array, 
converts it to a String using its toString () method and puts each 
result into a text view. It then displays each text view as a single row in 
the list view. 
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user an array adapter 


Add the array adapter to 
PrmkCategoryActivity 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


We’ll change the DrinkCategoryActivity.java code so that the list view uses an 
array adapter to get drinks data from the Drink class. We’ll put the code 
in the onCreate () method so that the list view gets populated when the 
activity gets created. 

Here’s the full code for the activity (update your code to reflect ours, then 
save your changes): 


package com.hfad.starbuzz; 

import android.app.ListActivity; 
import android.os.Bundle; 

import android.widget.ArrayAdapter; 
import android.widget.ListView; 


□ 


Starbuzz 


KU 

app/sre/main 


IVeYe usmj -these classes. 


java 


□ 


public class DrinkCategoryActivity extends ListActivity 

QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 

ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink>( 
this, 


com. hfad. starbuzz 


山 “ FmH 


DrinkCategory 

Activity.java 


android.R.layout.simple_list—item—l. 
Drink.drinks); 

listDrinks.setAdapter(listAdapter); 


This populates 七 he 
lis 七 v*ic>w v/rth d 3 *ta 
-fvom *thc dv-'mks 

avv-ay. 


These are all the changes that you need 
to get your list view to display a list of the 
drinks from the Drink class. 


These "the dv*i^ks -fvom 
七 he iVmk.dv’mks av-v-ay. 
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list views and adapters 


What happens when you rim the code 



When the user clicks on the Drinks option, DrinkCategoryActivity is launched. 


As DrinkCategoryActivity is a list activity, it has a default layout containing a single 
ListView object. This layout is created behind the scenes in Java code, so it’s not defined by 


XML. 



DrinkCategoryActivity ViewGroup 


ListView 



DrinkCategoryActivity creates an ArrayAdapter<Drink> / an array adapter 
that deals with arrays of Drink objects. 


DrinkCategoryActivity ArrayAdapter<Dnnk> 



The array adapters source is the drinks array in the Drink class. 

It uses the Drink. toString () method to return the name of each drink. 


o - 

DrinkCategoryActivity 



ArrayAdapter<Drink> 


Drink.drinks 



DrinkCategoryActivity makes the ListView use the array adapter using the 
setAdapter() method. 

The list view uses it to display a list of the drink names. 



ArrayAdapter<Drink> Drink.drinks 
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test drive 

Test drive the app 

When you run the app, TopLevelActivity gets 
displayed as before. When you click on the Drinks item, 
DrinkCategoryActivity is launched. It displays the names of 
all the drinks from the Dr ink Java class. 


Clidk oy\ IVmks ^ 

•to see a o( dhrmks. 


10:26 


落 forbuZT 



10:26 


Drinks 


Food 


Stores 



Latte 

Cappuccino 

Filter 



App review: where we've got to 


So far we’ve added Drink.java to our app, and created activities 
TopLevel Activity and DrinkCategoryActivity. 


Device 



|/Vc vc ertaitd 

activity—top_level.xml / 、 Drink.java, 



TopLevel Activity .java 


DrinkCategoryActivity.java 



activity—drink.xml 



The next thing we’ll do is get DrinkCategoryActivity to 
launch DrinkActivity, passing it details of which drink was 
clicked. 


DrinkActivity.java 

n r 

well get D\rihkCa-tcaov-yAd-tivi-tv 

"to 乙 all 
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list views and adapters 



Puzz]c 


Your goal is to create an activity that binds 
a Java array of colors to a spinner. Take 
code snippets from the pool and place 
them into the blank lines in the activity. 
You may not use the same snippet 
more than once, and you won’t need to 
use all the snippets. 


public class MainActivity extends Activity { 

String[] colors = new String[] {"Red ", "Orange", "Yellow ", "Green ", "Blue"}; 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_main); 

Spinner spinner = ( ) findViewByld(R•id•spinner); 

ArrayAdapter< > adapter = new ArrayAdapter< >( 


android.R.layout.simple_spinner_item f 

colors); ^ 

z N This displays cadh value -the avv-ay 

spinner. (adapter) ; 1 / 1 


as a s'm^le voy/ 七 he 


Note: each thing from 



► Answers on pa^e 267. 
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handling clicks 


How wg handled clicks m TopLcvelActivity 

Earlier on in the chapter, we needed to get TopLevelActivity to react 
to the user clicking items in the list view. To do that, we had to create an 
Onl temClickListener, implement its onltemClick () method, and 
assign it to the list view: 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


AdapterView.OnltemClickListener itemClickListener = new AdapterView.OnltemClickListener(){ 
public void onltemClick (AdapterView<?> listView, ^ The lis*t viev/ 

The \ic^ View iha-t was clicked, ils position m 
ihc lis-t -the v-ow ID o( -the unde\rly.mg daia. 

//Do something when an item is clicked 


View itemView, y 
int position, 
long id) { J 


ListView listView = (ListView) findViewById(R.id.list 一 options); 

listView. setOnltemClickListener (itemClickListener ); 《 七 lis-tc^cv -fco "the list view 


We had to set up an event listener in this way because list views aren’t 
hardwired to respond to clicks in the way that buttons are. 

So how should we get DrinkCategoryActivity to handle user clicks? 


UstActivity implements an item click listener by default 

There’s a significant difference between TopLevelActivity and 
DrinkCategoryActivity. Whereas TopLevelActivity is 
a normal Activity object, DrinkCategoryActivity is a 
ListActivity, a special type of activity that’s designed to work with list 
views. 

This is significant when it comes to handling user clicks. A key difference 
between Activity and ListActivity is that the ListActivity 
class already implements an on item click event listener. Instead of creating your 

own event listener, when you use a list activity you just need to 
implement the onListltemClick () method. 


public void onListltemClick(ListView listView, 

View itemView, 
int position, 
long id) { 

//Do something 


^ - These 3V*C same 

oy>| 七 emCkkO me 七 hod above has ： i\\t list 
v'icv/> 七 ViC\M dlidkcd ； 

position m -tKc list, ay>d 七 he \ro>w ID o^P 

i\\t u^dcv-lym^ data. 
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list views and adapters 


Pass data to aw activity using the 
ListActivity onListltemClickO method 


When you use a list activity to display categories, you’ll 
usually use the onListltemClick () method to start 
another activity that displays details of the item the user 
clicked. To do this, you create an intent that starts the second 
activity. You then add the ID of the item that was clicked as 
extra information so that the second activity can use it when 
the activity starts. 

In our case, we want to start DrinkActivity and pass it 
the ID of the drink that was selected. DrinkActivity will 
then be able to use this information to display details of the 
right drink. Here’s the code: 


Intent 



DrinkCategoryActivity 


DrinkActivity 


public void onListltemClick (ListView listView, ^^TiVis 乙 ailed v/he 灼 an .i 七 之你 s disked. 


View itemView, 
int position, 
long id) { 


D\r*mkCaic 3 o\ryA^tiviiy r^ccds io start 


Intent intent = new Intent(DrinkCategoryActivity.this, 
intent.putExtra(DrinkActivity.EXTRA_DRINKNO, (int) id); 

startActivity(intent); 丁 

1/VeYe usmj a dohs-ta^i -Po\r 七 he o( 七 he 

m-Pov-rwa-tio^ ihc so ihai v/c k^ow 


D\r*mkCa-tc3ovyAdiviiy a^d DvmkAdiviiy avc 
usmj i\)t same SVmj. Well add 七 he -fco 

Dv-mkA^tivi-ty whcr> wc ihc adtiviiy. 


DrinkActivity.class); 

Add IP o-f 七 ha 七 

>was dlidkcd *bo -the 
TKis is *tKc mdc/> o( *tKc dvmk 
•m 七 he dv*iy>ks avvay- 


It’s common practice to pass the ID of the item that was clicked as 
it’s the ID of the underlying data. If the underlying data is an array, 
the ID is the index of the item in the array. If the underlying data 
comes from a database, the ID is the ID of the record in the table. 
Passing the ID of the item in this way means that it’s easier for the 
second activity to get details of the data, and then display it. 

That’s everything we need to make DrinkCategoryActivity 
start DrinkActivity and tell it which drink was selected. The 
full activity code is on the next page. 
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DrinkCategoryActivity code 


The full PriwkCategoryActivity code 

Here’s the full code for DrinkCategoryActivity.java (add the new 
method to your code, then save your changes): 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


package com.hfad.starbuzz; 


import 

import 

import 

import 

import 

import 


android.app.ListActivity; 
android.os.Bundle; 


android.widget.ArrayAdapter; 
android.widget.ListView; 


android.view.View; ^_ 

android.content.Intent; 



dlssscs. 


public class DrinkCategoryActivity extends ListActivity { 



app/sre/main 




DrinkCategory 

Activity.java 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 

ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink>( 
this, 

android.R.layout.simple—list_item—l, 

Drink.drinks); 

listDrinks.setAdapter(listAdapter); 


@Override 

public void onListltemClick(ListView listView, 

View itemView, 


"the oy)Lis-iHemCliM) 
w'C-thod so -tha-t is 

laughed v/hch -the user dlidks oy \ ah 
i"tcrw \v\ "the lis-t view- 


int position, 


long id) { 

Intent intent = new Intent(DrinkCategoryActivity.this, DrinkActivity.class); 

/K 

intent.putExtra(DrinkActivity.EXTRA—DRINKNO, (int) id); 

startActivity (intent) ; ^ ••切从此 

so do 灼’七 wo\rV"Y A^dv"o'id Studio 
says i*t doesn't 
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A detail activity displays data 
for a single record 



list views and adapters 

Add resources 

TopLevelActivity 

DrinkCategoryActivity 

DrinkActivity 


As we said earlier, DrinkActivity is an example of a detail activity. A 
detail activity displays details for a particular record, and you generally 
navigate to it from a category activity. 


We’re going to use DrinkActivity to display details of the drink the 
user selects. The Drink class includes the drink name, description, and 
image resource ID ， so we’ll display this data in our layout. We’ll include 
an image view for the drink image resource, and text views for the drink 
name and description. 

Here’s our layout code. Add a new activity to your project called 々 

DrinkActivity with a layout called activity_drink, then replace 
the contents of activity_drink.xml with this: 


Make suv-c you dv-ca*tc 

*tKc ad*twi*ty* 


<LinearLayout xmlns : android= M http :// schemas.android.com/apk/res/android' 


xmlns : tools= n http :// schemas.android.com/tools" 
android:layout_width= M match_parent" 
android: layout—height= ， 'match—parent ’， 

android : orientation= n vertical，▼ 


□ 


Starbuzz 


43 

app/src/main 


tools : context= M com.hfad.starbuzz.DrinkActivity" > 


<ImageView 

android : id="@+id/photo M 
android : layout 一 width= n 190dp n 
android:layout_height= M 190dp M /> 

<TextView 

android : id= n @+id/name n 
android : layout 一 width:’▼ wrap—content” 
android : layout—height= n wrap 一 content，' /> 

<TextView 

android:id= n @+id/description n 
android:layout—width: n match_parent n 
android : layout height= n wrap content" /> 




□ 


res 



activity_drink.xml 



_atte 

\ couple of espresso shots with steamed milk 


</LinearLayout> 



Once you’ve created the layout of your detail activity, we can 
populate its views. 
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get a drink 


Retrieve data from the iwtewt 

As you’ve seen, when you get a category activity to start a detail 
activity, you get items in the category activity list view to respond 
to clicks. When an item is clicked, you create an intent to start the 
detail activity. You pass the ID of the item the user clicked as extra 
information in the intent. 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


When the detail activity is started, the detail activity can retrieve the 
extra information from the intent and use it to populate its views. 

In our case, we can use the information in the intent that started 
DrinkActivity to retrieve details of the drink the user clicked. 


When we created DrinkCategoryActivity, we added the ID 
of the drink the user clicked as extra information in the intent. We 
gave it a label of DrinkActivity. EXTRA—DRINKNO, which we 
need to define as a constant in DrinkActivity: 


public static final String EXTRA DRINKNO = "drinkNo"; 


As you saw in Chapter 3, you can retrieve the intent that started an 
activity using the get Intent () method. If this intent has extra 
information, you can use the intent’s get* () methods to retrieve it. 

Here’s the code to retrieve the value of EXTRA DRINKNO from the 
intent that started DrinkActivity: 

int drinkNo = (Integer)getlntent().getExtras()•get(EXTRA 一 DRINKNO); 

Once you’ve retrieved the information from the intent, you can use 
it to get the data you need to display in your detail record. 

In our case, we can use drinkNo to get details of the drink the 
user selected. drinkNo is the ID of the drink, the index of the 
drink in the drinks array. This means that you can get the drink 
the user clicked on using: 

Drink drink = Drink.drinks[drinkNo]; 

This gives us a Drink object containing all the information we 
need to update the views attributes in the activity: 

O name= ,, Latte /, 

description^"A couple of espresso shots with steamed milk” 
imageResourceId=R.drawable.latte 

drink 
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list views and adapters 


Update the views with the data 

When you update the views in your detail activity, you need to make sure 
that the values they display reflect the data you’ve derived from the intent. 

Our detail activity contains two text views and an image view. We need to 
make sure that each of these is updated to reflect the details of the drink. 


O name 

description 

imageResourceld 

drink 



Drink Magnets 

See if you can use the magnets below to populate the 
DrinkActivity views with the correct data. 


//Get the drink from the intent 

int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 
Drink drink = Drink.drinks[drinkNo]; 


// Populate the drink image 

工 mageView photo = ( 工 mageView)findViewByld(R.id.photo); 

photo. (drink.getlmageResourceld()); 

photo. (drink.getName()); 


// Populate the drink name 

TextView name = (TextView)findViewByld(R.id.name); 

name. (drink.getName()); 

I setlmageResourceld 

// Populate the drink description 

TextView description = (TextView)findViewByld(R•id•description); 
description. (drink.getDescription()); 
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magnets solution 



Drink Magnets Solution 

See if you can use the magnets below to populate the 
DrinkActivity views with the correct data. 


//Get the drink from the intent 

int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 
Drink drink = Drink.drinks[drinkNo]; 


V^u set the SOUV-dC 

°*P the 

TWis is needed 
bo make i\\t aff 
move aacssiblc. 


// Populate the drink image 

工 mageView photo = (ImageView)findViewByld(R.id.photo); 



// Populate the drink name 

TextView name = (TextView)findViewByld(R.id.name); 


name. 


Use sciTc^-tO -to 
sci 七 he 七 wt m a 
view. 




setText (drink.getName()); 


// Populate the drink description 

TextView description = (TextView)findViewByld(R•id.description); 


description . I se tText I (drink .getDescriptionO); 


/o\a didn’t t\ttd use -tiicsc. 



I se’ImageResourceld \ 
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The PriwkActivity code 

Here’s the code for DrinkActivity.java (replace the code the wizard 
gave you with the code below，then save your changes): 



list views and adapters 

Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 


□ 


Starbuzz 


package com.hfad.starbuzz; 

import android.app.Activity; 
import android.os.Bundle; 
import android.widget.ImageView; 
import android.widget.TextView; 

public class DrinkActivity extends Activity 


public static final String EXTRA—DRINKNO = "drinkNo"; 

一 Ar 

0Override Add B)(TRA_VKI^0 as a 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—drink); 


L d 

app/sre/main 


java 


com. hfad. starbuzz 

o 

DrinkActivity.java 


//Get the drink from the intent 

int drinkNo = (Integer)getlntent().getExtras()•get(EXTRA—DRINKNO); 

Drink drink = Drink.drinks[drinkNo]; ^ .. ., . . t ,, 

Use the dv-mk/Vo -to deiails 

o( "the dv-ihk -the usc\r (Most- 

//Populate the drink image 

ImageView photo = (ImageView) findViewByld(R. id.photo); 
photo.setlmageResource(drink.getlmageResourceId()); 
photo.setContentDescription(drink.getName()); 

//Populate the drink name 

TextView name = (TextView) findViewByld(R. id. name); 
name.setText(drink.getName()); 

//Populate the drink description 

TextView description = (TextView)findViewByld(R.id.description); 
description.setText(drink.getDescription()); 
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what happens 


What happens whew you ruw the app 



Add resources 
TopLevelActivity 
DrinkCategoryActivity 
DrinkActivity 



When the user starts the app, it launches TopLevelActivity. 



Device 



The onCreate() method in TopLevelActivity creates an 
onltemCIickListener and links it to the activity's ListView. 


O 

TopLevelActivity 


o, 

ListView 



onltemCI ickListener 



When the user clicks on an item in the list view, the 
onltemCI ickListener s onltemCI ick() method gets called. 

If the Drinks item was clicked, the onltemCI ickListener creates an intent to start 
DrinkCategoryActivity. 


onItemClick() 


Intent 



ListView 


onltemCI ickListener 


DrinkCategoryActivity 



DrinkCategoryActivity is a List Activity. 

The DrinkCategoryActivity list view uses an ArrayAdapter<Drink> to display a 
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list views and adapters 


The story continues 



When the user chooses a drink from the ListView, the onListltemCIick() 
method gets called. 


onListltemClickQ 



ListView 


DrinkCategoryActivity 



The DrinkCategoryActivitys onListltemCIick() method creates an intent to 
start DrinkActivity, passing along the drink number as extra information. 


Intent 




DrinkCategoryActivity 


DrinkActivity 



DrinkActivity is launched. 

It retrieves the drink number from the intent, and gets details for the correct drink from the 
Drink class. It uses this information to update its views. 


drinks [0] 
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test drive 


Test drive the app 

When you run the app, TopLevelActivity gets 
displayed as before. 



SteHbtizz 


囑 Coffee 


10:26 



pav*t o( 


►Icmc^-tcd Pv-*mks 
pav-t <^f the apf- T\\t o*tV>cv 
i*tcrws yjOY\{, do dnythm3 i*f 
you dl'idk Oh 


When you click on the Drinks item, 
DrinkCategoryActivity is launched. It 
displays all the drinks from the Drink java class. 


When you click on one of the drinks, 
DrinkActivity is launched and details of the 
drink the user selected are displayed. 




Using these three activities, you can see how to structure 
your app into top-level activities, category activities, and 
detail/edit activities. Later on, we’ll revisit the Starbuzz 
app so that you can see how you can retrieve the drinks 
from a database. 
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list views and adapters 



Paa] puzzjc §a]ufian 

Your goal is to create an activity that binds 
a Java array of colors to a spinner. Take 
code snippets from the pool and place 
them into the blank lines in the activity. 
You may not use the same snippet 
more than once, and you won’t need to 
use all the snippets. 


public class MainActivity extends Activity { 


String[] colors = new String[] {"Red ", 


"Orange ", "Yellow", "Green", "Blue"}; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

setContentView (R. layout. activity_main) ; WtY'C usihg dh ana 

Spinner spinner = ( Spinner ) f indViewByld (R. id. spinner) ; ^ __ of "type 

ArrayAdapter< String > adapter = new ArrayAdapter< String > ( 
this , 

android.R.layout.simple_spinner_item, 
colors); 


spinner. setAdapter (adapter); 


Wse sctAd3p*tcv-0 -to "the 
sp*mir>c\r -to use 七 he a\r\ray adapiev. 
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toolbox 



Your Android Toolbox 

You’ve got Chapter 6 under 
your belt and now you’ve 
added list views and app design 
to your toolbox. 


You da 饩 dov/y\load 

-full todt ^OV 
i\\t -from 

Wt 切 s://UY u v*Uom/ 

HcadF^s-tA^dv-oid- 




BULLET POINTS 


■ 


■ 


■ 


■ 


Sort your ideas for activities into top-level 
activities, category activities, and detail/ 
edit activities. Use the category activities to 
navigate from the top-level activities to the 
detail/edit activities. 

Image resources go in one or more of the 
drawable* folders. You reference them 
in your layout using @drawable/ 
image_name. You access them in your 
activity code using R. drawable. 
image_name. 

An imageview holds an image. Add it 
to your layout using 〈 imageview〉. Use 
android : src to set its source, and 

android : contentDescription 

to give it an accessible label. The 
equivalent methods in Java are 

setlmageResource () and 
setContentDescription(). 

A Listview displays items in a list. Add 
it to your layout using 〈 Listview〉. 

Use android : entries in your layout 
to populate the items in your list views from 
an array defined in strings.xml. 


m 


■ 


■ 


■ 


■ 


■ 


■ 


A ListActivity is an Activity 

that comes with a Listview. You get 
a reference to the Listview using 
getListView(). 

A ListActivity has its own default 
layout, but you can replace it with your 
own. 

An adapter acts as a bridge between an 
AdapterView and a data source. 

Listviews and Spinners are both 
types of AdapterView. 

An ArrayAdapter is an adapter that 
works with arrays. 

Handle click events on Buttons using 
android : onClick in the layout code. 

Handle click events on a Listview in 
a ListActivity by implementing the 

onList ItemClick () method. 

Handle click events elsewhere by creating 
a listener and implementing its click event. 


9 S31 PH. VIP 
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7 trsigments 


, Make it Modular 命 



You’ve seen how to create apps that work in the same way 
irrespective of the device they’re running on. 

But what if you want your app to look and behave differently depending on whether it’s 
running on a phone or a tablet? In this chapter, we’ll show you how to make your app 
choose the most appropriate layout for the device screen size. We ll also introduce 
you to fragments, a way of creating modular code components that can be reused by 
different activities. 


this is a new chapter 
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different screen s/zes 


Your app needs to look great ow al[ devices 

One of the great things about Android development is that you 
can put the exact same app on devices with completely different 
screen sizes and processors, and have them run in exactly the 
same way. But that doesn’t mean that they always have to look 
exactly the same. 


On a phone: 

Take a look at this image of an app on 
a phone. It displays a list of workouts, 
and when you click on one, you are 
shown the details of that workout. 

Ckk or\ m 3 list r 》 

\i lau^es a stCo^d ad-tivi-ty. 



On a tablet: 

On a larger device, 
like a tablet, you have 
a lot more screen 
space available. It 
would be good if 
all the information 
appeared on the 
same screen. On 
the tablet, the list of 
workouts only goes 
part-way across the 
screen, and when 
you click on an item, 
the details appear on 
the right. 



To make the phone and tablet user interfaces look different from 
each other, we can use separate layouts for large devices and 
small devices. 
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Your app may weed to behave differently too 


It’s not enough to simply have different layouts for different devices. 
You also need different Java code to run alongside the layouts so that 
the app can behave differently depending on the device. In our 
Workout app, for instance, we need to provide one activity for 
tablets, and two activities for phones. 


On a phone: 

ttcvc v/c have 

adtlVltlCS ： OY\t 

•the list dv>d OY\t -fov 

七 he details. 


12:45 



On a tablet: 



Put that means you might duplicate code 

The second activity that runs only on phones will need to insert the 
details of a workout into the layout. But that code will also need to 
be available in the main activity for when the app is running on a 
tablet. The same code needs to be run by multiple activities. 

Rather than duplicate the code in the two activities, we can use 
fragments. So what’s a fragment? 


you are here ► 


271 











fragments 


Fragments allow you to reuse code 


Fragments are like reusable components or subactivities. A 
fragment is used to control part of a screen, and can be reused 
between screens. This means we can create a fragment for the 
list of workouts, and a fragment to display the details of a single 
workout. These fragments can then be shared between layouts. 


The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 


|*f y/c use a 

-fov- {\\t 

<Jc y/ov-kou*b, 
we C^v\ v-cusc i*t m 
activities 



VJt ddh use 

a sepav-ale 

-rvagmcht -fo' 

the workout 
devils. 



Core Agony 

100 Pull-ups 
100 Push-ups 
100 Sit-ups 
100 Squats 




The Limb Loosener 


Core Agony 

100 Pull-ups 

100 Push-ups 

100 Sit-ups 

Core Agony 


The Wimp Special 


100 Squats 

Strength and Length 




K 1 


A fragment has a layout 

Just like an activity, a fragment has an associated layout. If 
you design it carefully, the Java code can be used to control 
everything within the interface. If the fragment code contains 
all that you need to control its layout, it greatly increases the 
chances that you’ll be able to reuse it elsewhere in the app. 

We’re going to show you how to create and use fragments by 
building the Workout app. 


272 Chapter 7 




























fragments 


The Workout app structure 

For most of this chapter, we’re going to focus on building the version 
of the app that displays two fragments alongside each other in a 
single activity. Here’s a breakdown of how the app is structured, and 
what it does. 


o 

o 

o 

o 

o 


When the app gets launched, it starts activity MainActivity. 

The activity uses layout activity—main.xml. 

The activity uses two fragments, WorkoutListFragment, and 
WorkoutDetailFragment. 

WorkoutListFragment displays a list of workouts. 

It uses fragment_workout_list.xml as its layout. 

WorkoutDetailFragment displays details of a workout. 

It uses fragment_workout_detail.xml as its layout. 

Both fragments get their workout data from Workout.java. 

Workout.jam contains an array of Workouts. 



R 

I </Layou-t> I 

activity—main.xml 


fragment— 
workout list.xml 




WorkoutList 

Fragment.java 


Device 


MainActivity.java 




Workout.java 


WorkoutDetail 

Fragment.java 


❹ 卜 A ] 

I </Layout> 1 

L_ J 


fragment— 
workout detail.xml 
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Here arc the steps 


There are a number of steps we’ll go through to build the app: 


o 


o 


Create the fragments. 

We’ll create two fragments. Workout List Fragment 
will be used to display a list of workouts, and 
WorkoutDetailFragment will be used to display 
details of a specific workout. We’ll display these 
fragments in a single activity. We’ll also add a plain old 
Java Workout class that the fragments will use to get 
their data from. 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Limb Loosener 

5 Handstand push-ups 
10 1 -legged squats 
15 Pull-ups 


^ Link the two fragments. 

When we click on a workout in 
Workout List Fragment, we want 
to display details of the workout in 
WorkoutDetailFragment. 


Create device-specific layouts. 

Finally, we’re going to change our app 
so that it looks and behaves differently 
depending on what sort of device it’s 
run on. If it’s run on a device with 
a large screen, the fragments will be 
displayed alongside each other. If 
not, they’ll be displayed in separate 
activities. 


Create the project 



You create the project for the app in exactly the same way you did for 
the previous chapters. 

Create a new Android project with a blank activity for an application 
named “Workout” with a package name of com . hf ad. workout. 
The minimum SDK should be at least API 17, as we’ll use this app in 
the next chapter to cover areas that require API 17 or above. You’ll 
need to specify an activity called “MainActivity’’ and a layout called 
“activity—main’’ so your code matches ours. 


Create fragments 
Link fragments 
Device layouts 
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The Workout class 

We’ll start by adding the Workout class to the app. 

Workout.java is a pure Java class file that the app will get workout data 
from. The class defines an array of four workouts, where each workout 
is composed of a name and description. Add the class to the com.hfad. 
workout package in the app/sre/main/java folder in your project, giving 
it a class name of Workout. Then save your changes. 



fragments 

Create fragments 
Link fragments 
Device layouts 


^ ^ has a a^d dcs^iptioh. 


package com.hfad.workout; 

public class Workout { _ 

private String name; 

private String description;^ y/ov-kou*b is dr> av-v-ay o-f -fouv l/Vovkouis. 

1^- 

public static final Workout[] workouts = { 



new Workout("The Limb Loosener", 

M 5 Handstand push-ups\nlO 1-legged squats\nl5 Pull-ups"), 
new Workout("Core Agony", 

’▼100 Pull-ups\nl00 Push-ups\nl00 Sit-ups\nl00 Squats"), 
new Workout("The Wimp Special", 

M 5 Pull-ups\nlO Push-ups\nl5 Squats"), 
new Workout("Strength and Length", 

"500 meter run\n21 x 1.5 pood kettleball swing\n21 x pull-ups") 



//Each Workout has a name and description 
private Workout(String name , String description) 
this.name = name; 
this.description = description; 


public String getDescription() { 

return description; 



public String getName () { ^ -Tiicsc av-c ^c*t*tcv-s 
return name; -fov fv-'iva*tc 


public String toString () { 

return this.name; 


vav-*iablcs. 

The 

o-P 

d l/Vovkou't is i-ts 


□ 


Workout 



app/sre/main 


java 


com. hfad. workout 

I \t\*u 

a 

Workout.java 


The data will be used by the fragment Workout Detail Fragment. 
We’ll create this fragment next. 
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How to add a fragment to your project 



Create fragments 
Link fragments 
Device layouts 


We’re going to add a new fragment called WorkoutDetailFragment 
to the project to display details of a single workout. You add a new 
fragment in a similar way to how you add a new activity. In Android 
Studio, go to File—>New".—fragment—fragment (Blank). 


You will be asked to choose options for your new fragment. Give the 
fragment a name of “WorkoutDetailFragment”，tick the option to create 


layout XML for it, and give the fragment layout a name of su es 七 lookm^ a*t Co&t 

fragment—workout_detail”. Untick the options to include fragment -fov- voia 

factory methods and interface callbacks; these options generate extra *tWis book. You 

code which you don’t need to use. When you’re done, click on the Finns' If 二 J some rt useful oy\ 

button - to do. 



When you click on the Finish button, Android Studio creates a new 
fragment file called WorkoutDetailFragment.java in the app/sre/main/ 
java folder, and a new layout file called fragment_workout—detail, xml'm 
the app/sre/res/layout folder. 
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Fragment layout code looks just like 
activity layout code 

We’ll start by updating the layout code for the fragment. Open the 
file fragment—workout—detail, xml’m the app/src/res/layout folder, and 
replace its contents with the code below: 


□ 

Workout 

L d 

app/src/main 

L Q 


res 


<?xml version= n l.0 n encodings"utf-8 n ?> 

<LinearLayout xmlns : android:’▼ http://schemas.android.com/apk/res/android" 
android : layout—height=”match_parent'▼ 
android : layout_width= n match_parent n 



layout 


JUL 


fragment— 
workout detail.xml 


android:orientation="vertical n > 


<TextView 

disflay'm^ 

*thc >wovkou*t 

dcsdv*if*tiov> 

*t>wo scpav-a*tc 


android : layout_width= n wrap_content" 
android : layout_height= n wrap—content” 

android : textAppearance= n ?android:attr/textAppearanceLarge 
android : text="" 

android: id= n @+id/textTitie’▼ /> 


TK'is "is y/ovkou*t 灼 ame- 


KTextView 

android : layout_width= M wrap_content" 
android : layout— height:"wrap 一 content” 
android : text= n " 

android : id= n @+id/textDescription n /> 
</LinearLayout> 


As you can see, fragment layout code looks just like activity layout 
code. This is a very simple layout made up of two text views: a text 
view with large text to display the name of the workout, and a text 
view with smaller text to display the workout description. When you 
write your own fragment layout code, you can use any of the views 
and layouts you’ve already been using to write activity layout code. 


This is -the 

>wo\rkou-t 

description. 


100 Pull-ups 
100 Push-ups 
100 Sit-ups 
100 Squats 



This is a 

七 ha 七 

y/e ta 灼 use msidc 
ouv activities. 


Now that we’ve created a layout for our fragment to use, we’ll look at 
the fragment code itself. 
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What fragment code looks like 



Create fragments 
Link fragments 
Device layouts 


The code for the fragment is held in WorkoutDetailFragment.java in the app/ 
sre/main/java folder. Open this file now. 

As you’d expect, Android Studio has generated Java code for you. Replace 
the code that Android Studio has generated with the code below: 


package com.hfad.workout; 


import android.app.Fragment; 
import android.os.Bundle; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup; 


T\\t dldss 

/Wvo’id 七乙 lass. 


Workout 





com. hfad. workout 


public class WorkoutDetailFragment extends Fragment { 

This is "the o^Cv*c3*tc\/icv/0 method- ("t^s C3\\td 
@Override ^ when A^dv-oid needs 七 he layou-t- 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 


Id 

WorkoutDetail 

Fragment.java 


return inflater.inflate(R.layout.fragment workout detail, container, false); 


} This -tells A^dv-oid whidh layoui ihc 

} uses (•… 七 his i"t s v/o\rkou"t 

detail). 一 一 

The above code creates a basic fragment. As you can see, it’s a class 

that extends the android. app . Fragment class. All fragments 
must subclass the Fragment class. 


Our fragment also implements the onCreateView () method. 
The onCreateView () method gets called each time Android 
needs the fragment’s layout, and it’s where you say which layout 
the fragment uses. This method is optional, but as you need to 



Watch it! 


All fragments must 
have a public 
no-argument 
constructor. 


implement it whenever you’re creating a fragment with a layout, 
you’ll need to implement it almost every time you create a fragment. 


You specify the fragment’s layout using the code 


This is because Android 
uses it to reinstantiate the fragment 
when needed, and if it’s not there, 
you’ll get a runtime exception. 


inf later. inflate (R. layout. f ragmen t—workou t—detail, 
container, false); 

This is the fragment equivalent of an activity’s 
setContentView () method. Just like setContentView (), 
you use it to say what layout the fragment should use. The 
container argument is passed by the activity that uses the fragment. 
It’s the ViewGroup in the activity that the fragment layout needs 
to be inserted into. 


In practice, you only need to add 
one to your fragment code if you 
include another constructor with 
one or more arguments. This is 
because if a Java class contains 
no constructors, the Java compiler 
automatically adds a public no¬ 
argument constructor for you. 
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Adding a fragment to aw activity's layout 

When we created our project, Android Studio created an activity for us 
called MainActivity.java, and a layout called activity—main.xml. We’re going to 
change the layout so that it contains the fragment we just created. 

To do this, open the activity—main, xml file in the app/sre/main/res/layout folder, 
and replace the code Android Studio has given you with the code below: 


<?xml version="l.0 n encoding= n utf-8"?> 


□ 

Workout 

L Q 

app/sre/main 
- 17^1 


res 



activity_main.xml 


<LinearLayout xmlns : android:'▼ http://schemas.android.com/apk/res/android" 
android : orientation= M horizontal n 


android : layout_width= n match_^parent M 
android : layout—height="match_parent n > 


〈fragment 

class= n com.hfad.workout.WorkoutDetailFragment" 
android : id= M @+id/detail_frag M 
android : layout_width="match_parent M 
android : layout_height= n match_parent n /> 
</LinearLayout> 


As you can see, the layout contains one element, <f ragment>. You 
use the <fragment〉element to add a fragment to an activity’s 
layout. You specify which fragment using the class attribute and 
setting it to the fully qualified name of the fragment. In our case, we’re 
going to create a fragment called WorkoutDetailFragment in the 
com. hfad. workout package, so we use 

class= n com.hfad.workout.WorkoutDetailFragment" 

We’ve created a fragment and got the activity to display it in its layout. 
So far, though, the fragment doesn’t actually do anything. What we 
need to do next is get the activity to say which workout to display, and 
get the fragment to populate its views with details of the workout. 


^ This adds i\\t 

Wbv-koiA-tPc-ta'ilFv-ajmcn-t -to 

layout 
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setWorkoutf) 

Passing the workout IP to the fragment 

When you have an activity that uses a fragment, the activity will usually 
need to talk to it in some way. As an example, if you have a fragment 
that displays detail records, you need the activity to tell the fragment 
which record to display details of. 

In our case, we need WorkoutDetailFragment to display details of 
a particular workout. To do this, we’ll add a simple setter method to the 
fragment that sets the value of the workout ID. The activity will then 
be able to use this method to set the workout ID. Later on, we’ll use the 
workout ID to update the fragment’s views. 

Here’s the revised code for WorkoutDetailFragment (update your 
code with our changes): 



Create fragments 
Link fragments 
Device layouts 


package com.hfad.workout; 


u 

Workout 


import 

import 

import 

import 

import 


android.app.Fragment; 

android.os.Bundle; 

android.view.LayoutInflater; 

android.view.View; 

android.view.ViewGroup; 



com. hfad. workout 


public class WorkoutDetailFragment extends Fragment { 

private long workoutld; *, s -the IP {ht >wovkou*t usev dhooscs. 

Latcv-, v/c II use *i*t *to sc*t i\\t values of 
@Override wov-kou*t details. 


I U\»i* 

Id 

WorkoutDetail 

Fragment.java 


public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

return inflater•inflate(R.layout•fragment—workout—detail, container, false); 


public void setWorkout(long id) { 
this.workoutId = id; 


This is d settev* method -Po\r "the wov-kout 
ID- The a^tivi-ty will use -this method -fco 
set the value o\ -the wov-kout ID- 


The activity needs to call the fragment’s setWorkout () method and 
pass it the ID of a particular workout. Let’s see how. 


280 Chapter 7 











fragments 


fret the activity to set the workout IP 


Before an activity can talk to its fragment, the activity first needs 
to get a reference to it. To get a reference to the fragment, you first 
get a reference to the activity’s fragment manager using the 
activity’s getFragmentManager () method. You then use its 
f indFragmentByld () method to get a reference to the fragment: 


getFragmentManager() 


.findFragmentByld(R.id.fragment id) 


Uis is IP ^ 


s 


The fragment manager is used to manage any fragments used by the 
activity. You use it to get references to fragments, and perform fragment 
transactions. You’ll see more about this later in the chapter. 

Here’s our full activity code (replace the existing code in MainActivity.java 
with the code shown here): 


、 •f’mdFVaye>vtBy|dO is a 
bii like ^*md\/icy/By|dO 
e 乂乙 ep 七 you use ii io yt 3 
>rt^Crtt\U -to a 


package com.hfad.workout; 

import android.app.Activity; 
import android.os.Bundle; 

public class MainActivity extends Activity { 


□ 

Workout 

app/sre/main 

L Q 

java 


@ Override com. hfad. workout 

protected void onCreate(Bundle savedlnstanceState) { ^~ 

super. onCreate (savedlnstanceState) ; MainActivity.java 

setContentView(R.layout.activity_main); 

WorkoutDetailFragment frag = (WorkoutDetailFragment) 

getFragmentManager() .findFragmentByld(R.id.de tail_frag) 
frag.setWorkout(1);^ 




1/VeYe b> l^o\rkoulDctailFv-a^chi io display 
details o( a v/o\rkout -to dhctk ii^s v/ov-k'mj. 


This us a vc-fcvcr>dc *to 
l/Vorkou 七 Its id • … 
*tV>c adtivi-ty^s layou*t >s dc*t3il_fv*a^. 


As you can see, we’ve got a reference to the fragment after calling 
setContentView () . This is really important, because before this, the 
fragment won’t have been created. 


We’re using the code frag. setWorkout ( 1 ) to tell the fragment 
which workout we want it to display details of. This is the custom method 
that we created in our fragment. For now, we’re just setting the ID of the 
workout in the activity’s onCreate () method so that we can see some 
data. Later on, we’ll change it so that the user can select which workout 
they want to see. 

The next thing we need to do is get the fragment to update its views when 
the fragment is displayed to the user. But before we can do this, we need 
to understand the fragment’s lifecycle. 
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Activity states revisited 

Just like an activity, a fragment has a number of key lifecycle methods that 
get called at particular times. It’s important to know what these are and when 
they get called so your fragment works in just the way you want. 

Fragments are contained within and controlled by activities, so the fragment 
lifecycle is closely linked to the activity lifecycle. Here’s a reminder of the 
different states an activity goes through, and on the next page we’ll show you 
how these relate to the fragment. 



Create fragments 
Link fragments 
Device layouts 



Activity created 



The activity is created when its 
onCreate() method runs. 

At this point, the activity is initialized, 
but isn’t visible. 



The activity is started when its 
onStart() method runs. 

The activity is visible, but doesn’t have 
the focus. 




The activity is resumed when its 
onResume() method runs. 

The activity is visible, and has the focus. 



The activity is paused when its 
onPause() method runs. 

The activity is still visible, but no longer 
has the focus. 


Activity stopped 



The activity is stopped when its 
onStopO method runs. 

The activity is no longer visible, but still 
exists. 


Activity destroyed 


The activity is destroyed when 
its onDestroyO method runs. 

The activity no longer exists. 
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The fragment lifecycle 


A fragment’s lifecycle is very similar to an activity’s，but it has a few 
extra steps. This is because it needs to interact with the lifecycle of 
the activity that contains it. Here are the fragment lifecycle methods, 
along with where they fit in with the different activity states. 


Activity States 


Fragment callbacks 


Activity created 


onAttach() 


onCreate() 


onCreateView() 


onActivityCreated() 


Activity started 


onStart() 


Activity resumed 


onResume() 


Activity paused 


onPause() 


Activity stopped 


onStop() 


Activity destroyed 


onDestroyView() 


onDestroy() 


onDetach() 


onAttach(Activity) 

This happens when the fragment is associated with an 
activity. 

onCreate(Bundle) 

This is very similar to the activity’s onCreate () method. 

It can be used to do the initial setup of the fragment. 

onCreateView(LayoutInflater, View&roup, Bundle) 

Fragments use a layout inflater to create their view at this 
stage. 

onActivityCreated(Bundle) 

This method is called when the onCreate () method of 
the activity has completed. 

onStart() 

The onStart () method is called when the fragment is 
about to become visible. 


onResume() 

Galled when the fragment is visible and actively running. 

onPause() 

Galled when the fragment is no longer interacting with 
the user. 

onStopO 

Galled when the fragment is no longer visible to the user. 

onDestroyView() 

Gives the fragment the chance to clear away any 
resources that were associated with its view. 

onDestroyO 

In this method, the fragment can clear away any other 
resources it created. 

onDetach() 

When the fragment finally loses contact with the activity. 
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Fragment class 


Your fragment Inherits the lifecycle methods 


As you saw earlier, your fragment extends the Android 
fragment class. This class gives your fragment access to 
the fragment lifecycle methods. 


Create fragments 
Link fragments 
Device layouts 


5bj^t Object class 

- (java.Iang.Object) 

△ 


Fragment 

onAttach(Activity) 

onCreate(Bundle) 

onCreateView(Layoutlnflater, 
ViewGroup, Bundle) 

onActivityCreated(Bundle) 

onStartO 

onResumeO 

onPauseO 

onStopO 

onDestroyView() 

onDestroyO 

onDetach() 

getView() 


Fragment class 

(android.app.Fragment) 

Tiie ddss implements dc-P^ult vcv*sio^s 

d 七 he li-fcdydlc me 七 hods. I 七 also o-thev- 

rweihods 七 ha 七 v\tcd, sudh as gctl/icv/O. 


YourFragment 

onCreateView(Layoutlnflater, 
ViewGroup, Bundle) 

yourMethodQ 


YourFragment class 

(com.hfad.foo) 

Mos 七 of *tV>c bchaviov of youv is 

Kdr>dled by sufcv-tlass methods. AH do is 
ovcv*v*'idc methods you 


Even though fragments have a lot in common with activities, the 
Fragment class doesn’t extend the Activity class. This means that 
some methods that are available to activities aren’t available to fragments. 


Note that the Fragment class doesn’t implement the Context class. 
Unlike an activity, a fragment isn’t a type of context and therefore doesn’t 
have direct access to global information about the application environment. 
Instead, fragments must access this information using the context of other 
objects such as its parent activity. 
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Set the view's values in the fragment's owStartO method 


We need to get WorkoutDetailFragment to update its views with details 
of the workout. We need to do this when the activity is started, so we’ll use 
the fragment’s onStart () method. Here’s the code: 


package com.hfad.workout; 


import 

import 

import 

import 

import 

import 


android.app.Fragment; 
android.os.Bundle; 


android.view.Layoutlnflater; 
android.view.View; 


android.view.ViewGroup; 

android.widget.TextView; 




WlcVc usm^ tlass *m 七 he 
。灼 S*tav* 七 0 mc*tKod- 


public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 


□ 

Workout 

L d 

app/sre/main 



com. hfad. workout 



WorkoutDetail 
Frag merit, java 


@Override 

public View onCreateView(Layoutlnflater inflater A ViewGroup container. 

Bundle savedlnstanceState) { 

return inflater•inflate(R.layout•fragment—workout—detail, container, false); 


public void onStart () { ^iViev/O t^cihod jcb ihc \rooi 

super. onStart () ; l/icw. Wc then use tliis "to yt -fco ihc 

View view = getView () ; dcs£.v*ip'tio^ views, 

if (view != null) { 

TextView title = (TextView) view.findViewByld(R.id.textTitle); 

Workout workout = Workout.workouts[(int) workoutld]; 
title.setText(workout.getName()); 

TextView description = (TextView) view.findViewByld(R.id.textDescription); 
description.setText(workout.getDescription()); 

} 

} 

public void setWorkout(long id) { 
this•workoutld = id; 


As we said on the previous page, fragments are distinct from activities, and 
therefore don’t have all the methods that an activity does. Fragments don’t 
include a findViewByld () method, for instance. To get a reference to 
a fragment’s views, we first have to get a reference to the fragment’s root 
view using the getView () method, and use that to find its child views. 

Now that we’ve got the fragment to update its views, let’s take the app for 
a test drive. 


You skoulct always call 
up to tke superclass 
wken you implement 
any fragment liiecycle 
metkocts. 
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Test drive the app 

When we run the app, details of a workout appear on the 
device screen. 

The app looks the same as if the workout details were 
displayed within an activity. Because the activity is using a 
fragment to display details of the workout, we can reuse the 
fragment in another activity if we want to. 


What happens whew you run the app 



Create fragments 
Link fragments 
Device layouts 




ore Agony 

100 Pull-ups 

= 令 DWU oUk T kout are 

disflaycdi m ⑼七 . 


100 Sit-ups 
100 Squats 



When the app is launched, activity Main Activity gets created. 



MainActivity 

MainActivity passes the workout ID to WorkoutDetailFragment in its 
onCreateQ method by calling the fragments setWorkout() method. 



Device 




MainActivity Fragment 

The fragment uses the value of the workout ID in its onStart() method to 
set the values of its views. 



MainActivity 



textTitle ： CoreAgony 

textDescription ： 100 Pull ups 

100 Push-ups 


WorkoutDetail 

Fragment 


100 Sit ups 
100 Squats 
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Where we've got to 

So far, weVe created MainActivity.java, its layout activity—main, 
xml, the fragment WorkoutDetailFragment.java, its layout fragment— 
workout_ detail, xml, and the plain old Java class file Workout.java. 
MainActivity uses WorkoutListFragment to display 
details of the workout, and it gets the workout data from the 
Workout class. 




activity—main.xml 


fragment— 



MainActivity.java 


workout detail.xml 



WorkoutDetail 
Fragment.java Workout.java 



The next thing we need to do is create the fragment 
WorkoutListFragment to display a list of the workouts. 



Why can’t an activity get a fragment by calling the 
findViewByld () method? 

Because f indViewByld () always returns a View 
object and, surprisingly, fragments aren’t views. 

Why isn’t findFragmentByld () an activity 
method like f indViewByld () is? 

That’s a good question. Fragments weren’t available in early 
versions of Android. It uses the fragment manager as a way to add 
a whole bunch of useful code for managing fragments, without 
having to pack lots of extra code into the activity base class. 


Why don’t fragments have a f indViewByld () 
method? 

Because fragments aren’t views or activities. Instead, you 
need to use the fragment’s getview () method to get a 
reference to the fragment’s root view, and then call the view’s 
f indViewByld () method to get its child views. 

Activities need to be registered in AndroidManifest.xml so 
that the app can use them. Do fragments? 

No. Activities need to be registered in AndroidManifest.xml, but 
fragments don't. 
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Wc need to create a fragment with a list 

Now that we’ve got WorkoutDetailFragment working, we need to 
create a second fragment that contains a list of the different workouts. 
We’ll then be able to use the fragments to create different user interfaces 
for phones and tablets. 



Create fragments 
Link fragments 
Device layouts 



You’ve already seen how to add a list view to an activity. We 
can create a fragment that contains a single list view, and 
then update it with the names of the workouts. 


O 


0 




So the fragment will contain just a 
single list. I wonder... When we wanted 
to use an activity that contained a single 
list, we used a List Activity. Is there 
something similar for fragments? 








He’s right. We can use a type of fragment 
called a ListFragment. 

We’ll look at this on the next page. 
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A ListFragmcwt is a fragment 
that contains only a list 


A list fragment is a type of fragment that specializes in working with a list. 
Just like a list activity, it’s automatically bound to a list view, so you don’t 
need to create one yourself. Here’s what one looks like: 


A lis*t domes 

tomflctc its ovm 
list viev/ so you do 於七 

bo add \i youvscl-f^^7 

You \us*t Y\ttd *to fv-ovidc 

i 七 W\{}\ da*ta* 



Just as with a list activity, there are are a couple of major advantages in 
using a list fragment to display categories of data: 



You doiVt need to create your own layout. 

List fragments define their own layout programmatically, so 
there’s no XML layout for you to create or maintain. The 
layout the list fragment generates includes a single list view. You 
access this list view in your activity code using the list fragment’s 
getListView () method. You need this in order to specify what 
data should be displayed in the list view. 



You don't have to implement your own event listener. 

The List Fragment class is registered as a listener on the list 
view, and listens for when items in the list view are clicked. You 
use the list fragment’s onListl temClick () method to get 
fragment to respond to clicks. You’ll see this in action later on. 


So what does the list fragment code look like? 


Lis-tFv-agmch-t is a 
subdldss of P\r3^rwCh't. 


android.app.Fragment 

A 


android.app.ListFragment 

getListView() 

getListAdapter() 

setListAdapter() 

onListltemClickO 


A ListFrag[ment 
is a type oi 
Fragment tkat 
specializes in 
working witk a 


List View. It lias 

a default layout 
tkat contains tke 
ListView. 
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create a ListFragment 

How to create a list fragment 



Create fragments 
Link fragments 
Device layouts 


You add a list fragment to your project in the same way you add a 
normal fragment. Go to File^-New...^-Fragment^Fragment (Blank). 
Give the fragment a name of “WorkoutListFragment”，and then untick 
the options to create layout XML, and also the options to include 
fragment factory methods and interface callbacks. List fragments 
define their own layouts programmatically, so you don’t need Android 
Studio to create one for you. When you click on the Finish button, 
Android Studio creates a new list fragment for you in a file called 
WorkoutListFragment.java in the app/src/main/java folder. 

Here’s what the basic code looks like to create a list fragment. As you 
can see, it’s very similar to that of a normal fragment. Replace the code 
in Workout List Fragment with the code below: 


package com.hfad.workout; 


import 

import 

import 

import 

import 


public 


android.os.Bundle; 


android.app.ListFragment; 
android.view.Layoutlnflater; 


android.view.View; 
android.view.ViewGroup; 


class WorkoutListFragment 


TKc adtivi-ty y>ccds *to c%icir>d 
Lis 七此朽。七 FVa ， ⑺七. 


extends ListFragment 


@Override 


□ 

Workout 

L C3 

app/sre/main 

L C3 


java 


com. hfad. workout 

I \cb%t 

O 

WorkoutList 


Fragment.java 


public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 


return super.onCreateView(inflater, container, savedlnstanceState); 




The above code creates a basic list fragment called 

Workout List Fragment. As it’s a list fragment, it needs to extend 

the ListFragment class rather than Fragment. 


Callmj -the supcv-dlass o^C\rca"tcl/icv/0 
method gives you ihc dc-fauli layoui 

-Po\r ihc 


The onCreateView () method is optional. The onCreateView () 
method gets called when the fragment’s view gets created. We’re 
including it in our code as we want to populate the fragment’s list view 
with data as soon as it gets created. If you don’t need your code to do 
anything at this point, you don’t need to include the method. 

Let’s see how to add data to the list view. 
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Well use an ArrayAdaptcr to set the values m the ListVicw 


As mentioned in Chapter 6, you can connect data to a list view using an 
adapter. This is still the case when your list view is in a fragment; ListView is 
a subclass of the AdapterView class, and it’s this class that allows a view to 
work with adapters. 

We want to supply the list view in Workout List Fragment with an array of 
workout names, so we’ll use an array adapter to bind the array to the list view. 


This IS OUV IlS 七 

V 


l/Ve’ll dircaic av\ avray adap-tev -to 
bmd ou\r list view b> av-v-ay- 


This is av-vay. 


ListView 


> 


Array 

Adapter 


Workout 

names 


A Fragment isn't a type of Context 

As you’ve already seen, to create an array adapter that works with a list view, 
you use: 

•ArrayAdHpt6r<DataType> listAdapter = new ArrayAdapter<DataType> ( 

context, android.R.layout.simple_list—item—l, array); 

where DataType is the type of data, array is the array and context is the 
current context. 

When we used this in an activity, we could use this to get the current context. 

We could do this because an activity is a type of context — the Activity class 
is a subclass of the Context class. 

As you saw earlier, the Fragment class isn’t di subclass of the Context class, 
so using this won’t work. Instead, you need to get the current context in some 
other way. If you’re using the adapter in the fragment’s onCreateView () 
method as we are here, you can use the LayoutInflator object’s 
getContext () method to get the context instead: 

ArrayAdapter<DataType> listAdapter = new ArrayAdapter<DataType>( 

TiVis yts you ^-inflator. getContext () , android.R.layout.simple—list—item_l, 

Once you’ve created the adapter, you bind it to the ListView using the 
fragment’s setListAdapter () method: 

setListAdapter (listAdapter); 

Let’s use an array adapter to populate the list view in our fragment with a list of 
workouts. 

you are here 


array); 
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WorkoutListFragment code 

The updated WorkoutListFragmcwt code 



Create fragments 
Link fragments 
Device layouts 


We’ve updated our WorkoutListFragment.jam code so that it 
populates the list view with the names of the workouts. Apply 
the changes to your code, then save your changes: 


package com.hfad.workout; 


Z3 

Workout 


import 

import 

import 

import 

import 

import 


android.os.Bundle; 


android.app.ListFragment; 
android.view.Layoutlnflater; 


android.view.View; 
android.view.ViewGroup; 

android.widget.ArrayAdapter; 


WcVc us'm^ *tWis dlass m 


public class WorkoutListFragment extends ListFragment { 


L Q 

app/sre/main 


java 


□ 


com. hfad. workout 

Q 

WorkoutList 

Fragment.java 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 


String[] names = new String[Workout.workouts.length]; 
for (int i = 0; i < names.length; i++) { 

names[i] = Workout.workouts[i].getName(); 


} $ 

] an av-v-ay adapW- Create a SVihg o( the wo\rkout v\a^cs. 

V 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 

七 he doh*tc%*t -fvom ^ inf later. getContext () , android. R. layout. simple_list_item_l, 
-the layout names); 

setListAdapter (adapter) ; Bihd the av-v-ay adayic^r io the list view. 


return super.onCreateView(inflater, container, savedlnstanceState); 


Now that the WorkoutListFragment contains a list of 
workouts, let’s see what it looks like by using it in our activity. 
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display WorkoutListFragmcwt 
iw the MaiwActivity layout 

We’re going to add our new 

WorkoutListFragment to ourMainActivity 
layout so that it appears to the left of 
Workout Detail Fragment. Displaying fragments 
side by side in this manner is a common way of 
designing apps to work on tablets. 

To do this, we’ll use a linear layout with a horizontal 
orientation. We’ll use layout weights to control how 
much horizontal space each fragment should take up. 

Here’s the code below (update your version of activity— 
main.xml to reflect our changes): 



<?xml version= M 1.0" encoding= M utf-8"?> 

〈LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
android : orientation= M horizontal" 


android : layout—width= n match—parent n 


android : layout—height=’ ， match—parent ’，> 

Pisflay 

〈fragment >wovkou*ts Tiv*s*t. 

class= n com.hfad.workout.WorkoutListFragment' 


android : id="@+id/list—frag” 

android : layout_width= n Odp" 

android : layout_weight="2 M 

android : layout__height= M match_parent n /> 


<fragment 
class: 


The 灼 display 七 he 
wov-kout derails. 

com.hfad.workout.WorkoutDetailFragment' 



Workout 





activity_main.xml 


android : id="@+id/detail—frag" 

android : layout_width="Odp" WcVc us*m^ layou*t_>wCi^*t *to 乙。灼 *brol \\o^i 

android: layout—weight= n 3'▼ ^^ 一 你 uA spade cadK should "take 

android : layout_height="match_parent" / > 

</LinearLayout> 


Let’s see what the app now looks like. 
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test drive 

Test drive the app 

When we run the app, a list of the workouts 
appears in a list on the left of the screen, and 
details of a single workout appear on the 
right. We hardcoded which workout should 
appear in our MainActivity.java code, so no 
matter which workout the user clicks on, 
details of the Gore Agony workout will be 
displayed. 



We need to get WorkoutPctailFragwewt to 
respond to clicks w WorkoutUstFragmewt 

Here’s a reminder of where we’ve got to with our app. As you 
can see, we’ve now created all the components our app needs: 



activity—main.xml 



WorkoutList 

Fragment.java 


Device 


MainActivity.java 




Workout.java 


WorkoutDetail 


We’re not finished coding these components though. 
Instead of displaying details of a hardcoded workout 
in WorkoutDetail Fragment, we need to get it 
to display details of the workout the user clicks on in 
WorkoutListFragment. 



fragment— 
workout detail.xml 
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Wiring up the list to the detail H 

There are a few ways that we can make the detail change when 
an item is clicked on the list. We’ll do something like this: 

❶ Add code to WorkoutListFragment that waits for a workout to be 
clicked. 

❺ When that code runs, we’ll call some code in MainActivity.java that... 
o ...will change the details in the detail fragment. 


V 


We don’t want to write code in Workout List Fragment 
that talks directly to Workout Detail Fragment. Can you 
think why? 


fragments 

Create fragments 
Link fragments 
Device layouts 


The answer is reuse. We want our fragments to know as little 
as possible about the environment that contains it. The more 
a fragment needs to know about the activity using it, the less 


reusable it is. 



0 


Wait a minute! You re saying you doiVt 
want the fragment to know about the 
activity that contains it? What about your 
second point? Aren't we making it depend 
on MainActivity? Won’t that mean we can’t 
use it in another activity? 


We need to use an interface to decouple 
the fragment from the activity. 
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Wc need to decouple the fragment with aw interface 

We have two objects that need to talk to each other — the fragment 
and the activity — and we want them to talk without one side knowing 
too much about the other. The way we do that in Java is with an 
interface. When we define an interface, we’re saying what the minimum 
requirements are for one object to talk usefully to another. It means that we’ll 
be able to get the fragment to talk to any kind of activity, so long as 
that activity implements the interface. 

We’re going to create an interface called WorkoutLis tLis tener, 
that looks like this: 

interface WorkoutListListener { 
void itemClicked(long id); 



So long as an activity implements this interface, we'll be able to tell it 
that an item on the list fragment has been clicked. This is what will 
happen at runtime: 


o 

❺ 

o 

o 


The WorkoutListListener will tell the fragment that it wants to listen. 


A user will click on a workout in the list. 

The onList ItemClicked () method in the list-fragment will be called. 

That method will then call the WorkoutListListener^ 
itemClicked () method with the ID of the workout that was clicked 


Put whew will the activity say that ifs listening? 

When will the activity tell the fragment that it’s ready to receive 
updates about what item’s been clicked? If you look back at the 
fragment lifecycle, you’ll see that when the fragment is attached to the 
activity, the fragment’s onAttach () method is called with the value 
of the activity: 

@Override 

public void onAttach(Activity activity) { 


We can use this method to register the activity with the fragment. 
Let’s take a look at the code. 
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First add the interface to the list fragment 



fragments 

Create fragments 
Link fragments 
Device layouts 


We’ve updated our WorkoutListFragment.jam code to add a listener 
(apply the changes to your code, then save your work): 

package com.hfad.workout; 

import android.os.Bundle; 
import android.app.ListFragment; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup; 
import android.widget.ArrayAdapter; 
import android. app. Activity; dlasscs. 

import android.widget.ListView ;^ ' 

public class WorkoutListFragment extends ListFragment 

static interface WorkoutListListener { 
void itemClicked(long id); 


Workout 


L Q 

app/sre/main 

"13 



java 


com. hfad. workout 

山 " F««{| 

a 

WorkoutList 

Fragment.java 


Add "the lis-tc^cv- -to -the 


private WorkoutListListener listener; 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

String[] names = new String[Workout.workouts.length]; 
for (int i = 0; i < names.length; i++) { 

names[i] = Workout.workouts[i].getName(); 

} 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 

inflater.getContext (), android.R.layout.simple—list—item_l, 
names); 


setListAdapter(adapter); 

return super•onCreateView(inflater, container, savedlnstanceState); 



@Override 

public void onAttach(Activity activity) { 
super.onAttach(activity); 
this.listener = (WorkoutListListener)activity; 


TVis is called 
■to a 匕 twity. 


@Override 

public void onListltemClick(ListView 1, View v, int position, long id) { 
if (listener != null) { T|| . 

listener. itemClicked (id) ; tnc lis*tchc\r whch dh itcrw 

} V m the ListView is elided. 
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implement WorkoutListListener 


Thcw make the activity implement the interface 

Now we need to make MainActivity.java implement the 
WorkoutListListener interface we just created. Update your 
code with our changes below: 

package com.hfad.workout; 


import 

import 

public 


android.app.Activity; 
android.os.Bundle; 

class MainActivity extends Activity 


Implemejvt 七 he lis-tc^cv- dc-f mcd 
•m l/Vov-kouiLis-tFv-agrwc^t 


implements WorkoutListFragment.WorkoutListListener 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 


super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_main); 




v-emove *t^csc I'mcs as 


y/cVc y\o lonyv 

y/V)'idV) >/o\rkoiA*t *to display- 


@Override 


public void itemClicked(long id) { 

//The code to set the detail will go here 

} 

This method is dc-r med m "the lis*tcr>cv*. 


When an item is clicked in the fragment, the itemClicked () 
method in the activity will be called. We can put code in this 
method to show the details of the workout that’s just been selected. 



Workout 


1 - [jj 

app/sre/main 



com. hfad. workout 



MainActivity.java 


Put how do we update the workout details? 

The WorkoutDetailFragment updates its views when the 
fragment is started. But once the fragment is displayed on screen, 
how do we get the fragment to update the details? 

You might be thinking that we could play with the fragment’s 
lifecycle so that we get it to update. Instead, we’ll replace the 
detail fragment with a brand-nezv detail fragment, each 
time we want its text to change. 


There’s a really good reason why... 
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fragments 


You want fragments to work 
with the back buttow 


V 


Create fragments 
Link fragments 
Device layouts 


Suppose a user clicks on one workout, then a second workout. When 
they click on the back button, they’re going to expect to be returned 
back to the first workout they chose. 



In every app we’ve built so far, the back button has returned the user 
to the previous activity. Now that we’re using fragments, we need to 
understand what happens when you click the back button. 


Welcome to the back stack 


The back stack is the list of places that you’ve visited on the device. 
Each place is a transaction on the back stack. 


A lot of transactions move you from one activity to another: 


Transaction ： Go to inbox activity ^ 

Transaction ： Go to ‘compose new mail，activity 
Transaction ： Go to sent mail activity 


TVicsc arc all separate 

*tv-air\sat*tioir\S. 


So when you go to a new activity, a transaction to do that is recorded 
on the back stack. If ever you press the back button, that transaction is 
reversed, and you’re returned to the activity you were at before. 


But back stack transactions don’t have to be activities. They can just be 
changes to the fragments on the screen: 

Transaction ： Replace the ‘Strength and length 5 detail fragment with a ‘Core agony 5 fragment 
Transaction ： Replace the ‘Core agony’ fragment with 'The wimp special. 


That means that fragment changes can be undone with the back button, 
just like activity changes can. 
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replace fragment 


Pow't update—instead, replace 

Instead of updating the views in Workout Detail Fragment, we will 
replace it with a new instance of WorkoutDetailFragment set up to 
display details of the next workout that’s been selected. That way, we can 
store the fragment replacement inside a back stack transaction, and the user 
will be able to undo the change by hitting the back button. But how do we 
replace one fragment with another? 

We’ll need to begin by making a change in the activity—main.xml layout file. 
Instead of inserting Workout Detail Fragment directly, we’ll use a 

frame layout. 

A frame layout is a type of view group that’s used to block out an area on 
the screen. You define it using the <FrameLayout> element. You use 
it to display single items — in our case, a fragment. We’ll put our fragment 
in a frame layout so that we can control its contents programmatically. 
Whenever an item in the Workout List Fragment list view gets clicked, 
we’ll replace the contents of the frame layout with a new instance of 
WorkoutDetail Fragment that displays details of the correct workout: 



Create fragments 
Link fragments 
Device layouts 


Actct a fragment to 

an activity using 
〈 fragment〉if you 
cton’t need it to 
respond to ckangfes 
in tke user interface. 
Otkerwise, use a 
<FrameLayout>. 


<?xml version="1.0" encoding 二 n utf-8 n ?> 

<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 


android : orientation="horizontal" 
android : layout_width= M match_parent" 
android : layout—height= n match 一 parent n > 


<fragment 

class= n com.hfad.workout.WorkoutListFragment" 

android : id="@+id/list—frag" 

android : layout—width="Odp" 

android : layout_weight="2" 

android : layout_height= n match_parent" / > 



<FrameLayout 


*to disfUy 

-fv-ajmcn-t msidc a Fv-a^cLayout 



□ 


Workout 


L [J 

app/src/main 


res 



layout 




activity_main.xml 


1/Vcll sdd "the bo "the 

•(Varwe layout pv-o^ammaiidally. 



android: id=，▼ @+id/ fragment 一 con tainer '▼ 


android : layout_width="Odp" 
android : layout_weight="3 n 
android : layout—height= n match—parent" / > 
</LinearLayout> 


Next, we’ll write the code to add the fragment to the frame layout. 
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Using fragment trawsactiows 

You replace the fragment at runtime inside a fragment transaction. A 
fragment transaction is a set of changes you want to apply relating to the 
fragment, all at the same time. 

To create a fragment transaction, you start by getting a 
FragmentTransaction from the fragment manager: 


WorkoutDetailFragment fragment = new WorkoutDetailFragment(); 

FragmentTransaction transaction = getFragmentManager().beginTransaction(); 


You then specify all the actions you want to group together in the transaction. 
In our case, we want to replace the fragment in the frame layout, and we do 
this using the fragment’s replace () method: 

transaction.replace(R.id.fragment—container, fragment); 

where R. id. fragment—container is the ID of the container containing 
the fragment. You may also add a fragment to a container using the add () 
method, or remove a fragment using the remove () method: 


TV^c s-tav-t o\ 

*t\rair\satt»oir\ 


This \rcpladcs ihc 

held’m 七 he 


transaction• add(R.id.fragment—container, fragment) ; you ddr> add or vemove 

transaction. remove (fragment) ; i-f you v/airvt. I 的 

ouv example, >wC do 的七 y\ttA 

You can use the setTransition () method to say what sort of transition *fco. 
animation you want for this transaction. 

transaction. setTransition (transition) ; You dov^i have {o set a 七 vansi 七 icm. 


where transition is the type of animation. Options for this are 
TRANSIT FRAGMENT_CLOSE (a fragment is being removed from the stack), 
TRANSIT FRAGMENT_OPEN (a fragment is being added), TRANSIT 
FRAGMENT FADE (the fragment should fade in and out) and TRANSIT 
NONE (no animation). 

Once you’ve specified all the actions you want to take as part of the transaction, 
you can use the addToBackStack () method to add the transaction to the 
back stack of transactions. This allows the user to go back to a previous state 
of the fragment when they press the Back button. The addToBackStack () 
method takes one parameter, a String name you can use to label the 
transaction: 


transaction.addToBackStack(null) 


Mos*t 七 he tiw'C you 

*tV>c -tv-a^sadtio^, so i*t 


v/o〆 七 Y\ttd b> vc*tv-*icvc 
dair> be sc*t *to ywa\1 


To commit the changes to the activity, you call the commit () method: 

transaction.commit(); 


The commit () method applies the changes. 
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The updated MainActivity code 



Create fragments 
Link fragments 
Device layouts 


We want to get a new instance of WorkoutDetailFragment that 
displays the correct workout, display the fragment in the activity using 
a fragment transaction, and then add the transaction to the back 
button back stack. Here’s the full code: 


□ 

Workout 


L Q 

package com. hfad. workout; app/sre/main 

L a 


import 

import 

import 


android.app.Activity; 
android.os.Bundle; 

android.app.FragmentTransaction; 


^ so wc wed *to \^ori 


public class MainActivity extends Activity 


java 

mu 

com. hfad. workout 

clatt F*«{| 

£j 

MainActivity.java 


implements WorkoutListFragment.WorkoutListListener { 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 


QOverride 

public void itemClicked (long id) { S*tav-*t 

WorkoutDetail Fragment details = new WorkoutDetailFragment () ; 七以⑹乙 * 

FragmentTransaction ft = getFragmentManager().beginTransaction(); 
details.setWorkout(id); 

ft. replace (R. id. fragment container, details) ; 备严 —d 

add i 七匕 仏 ! bad stadc 

ft•addToBackStack(null)/ _ 

.. and 

ft. setTransition (FragmentTransaction. TRANS IT 一 FRAGMENT 一 FADE) ; 冬 七 s "to 

f t • commit 0；^. C<W|Uhe “ sa “， }adt out 


Let’s see what happens when we run the code. 
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fragments 


Test drive the app 

When we run the app, a list of the workouts appears in a list on the 
left of the screen. When we click on one of the workouts, details of 
that workout appear on the right. If we click on another workout 
and then click on the back button, details of the workout we chose 
previously appear on the screen. 


11:33 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 


The Side o^c Stvccir> 
is empty you s*tav*t 

as usev* 七 dKoscr> 
a >wov*kou*t yc*t- 



The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 



11:35 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 


TV>C uscv* dl'ldks OY\ 1 /Virwf 
Sf>e£>idl y/ovkou 七 ar>d i*ts 
details yt displayed- 


The app seems to be working fine as long as 
you don’t rotate the screen. If you change 
the screen orientation, there’s a problem. 
Let’s see what happens. 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


11:34 


The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 
15 Pull-ups 


W\\tv\ the uscv dlidks oy\ -the 
Lirwb Loosc^C\r v/ovkou*^ i"ts 
details yt displayed. 



11:36 


The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 
15 Pull-ups 


W\)tv\ ihc usc\r dlidks oy\ ihc 
ba 匕 k buttoi^ -the aff goes 

batk "to "the Lirwb Loosc^cv* 
v/ovkout- 
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rotating again 


Rotating the device breaks the app 

When you rotate the app, there’s a problem. Regardless of which 
workout you’ve chosen, when you rotate the device, the app 
displays details of the first workout. 



Create fragments 
Link fragments 
Device layouts 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 

Choose ov\t *tV^c 

y/ovkou'ts) d 灼 cl Vts 

details affcav- 




When we first looked at the activity lifecycle, you saw how when 
you rotate the device, Android destroys and re-creates the activity. 
When this happens, local variables used by the activity can get lost. 
If the activity uses a fragment, the fragment gets destroyed 
and re-created along with the activity. This means that any 
local variables used by the fragment can also lose their state. 

In our Workout Detail Fragment, we use a local variable 
called workout Id to store the ID of the workout the user clicks 


The Limb 
Loosener 

Core Agony 

The Wimp 
Special 

Strength and 
Length 


The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 
15 Pull-ups 

W\\tv\ you \rct3*tc 
ihe device, details 
o-P the -Piv-si 
y/o\rkout a\rc shovm 
’ms 七 edd. This is -the 
v/ov-kout v/i-th 

o( O \v\ -the 

wov-kou-ts av-v-ay. 


on in the Workout List Fragment list view. When the user 
rotates the device, workout Id loses its current value and it’s set 
to 0 by default. The fragment then displays details of the workout 
with an ID of 0 — the first workout in the list. 


You deal with this problem in a fragment in a similar way to how 
you deal with it in an activity. You first override the fragment’s 
onSavelnstanceState () method, and put the local variable 
whose state you want to save in the method’s Bundle parameter: 


public void onSavelnstanceState(Bundle savedlnstanceState) { 


savedlnstanceState•putLong( n workoutId n , workoutld); 

} 

You then retrieve the value from the Bundle in the fragment’s 
onCreateView () method: 


oy>Savc I r>s*tair>dcS*ta*tc() 
me 七 hod tailed bc-Pov-c 

i\\t is des-tv-oyed- 


if (savedlnstanceState != null) { 

workoutld = savedlnstanceState•getLong( n workoutId n ); 


We’ll show you the revised code on the next page. 


iVe 乙 an “sc i 七 "to yt 七 he pv-evious 
state o-f -the wov-kou-tld variable- 
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The WorkoutPetailFragmcwt code 

package com.hfad.workout; 

• • • Ko Y\t^j *impov*b 3v-c vc<\u*ivcd so skipped 七 hem. 

public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 

QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup 

Bundle savedlnstanceState) { 

if (savedlnstanceState != null) { 


□ 

Workout 

L Q 

app/sre/main 


java 


com. hfad. workout 

F«I{1 

container, | 广 j 

WorkoutDetail 


Fragment.java 


workoutld = savedlnstanceState. getLong ("workoutld"); 


犬 "the value o-P "the v/o\rkou"t|d- 


return inf later . inflate (R. layout. f ragment_workout_detailcontainer, false); 


@Override 


public void onStart() { 

super.onStart(); 

View view = getView(); 
if (view != null) { 

TextView title = (TextView) view.findViewByld(R.id.textTitle); 
Workout workout = Workout.workouts[(int) workoutld]; 


title.setText(workout.getName()); 

TextView description = (TextView) view•findViewByld(R•id•textDescription); 
description.setText(workout.getDescription()); 


} Save the value the wov-kou*tld m -the savedBundle bc-fov-c the 

fleets destv-oved. WcVc v-ctv-icv'mft i*t m the o^Cv-ca*tc\/icv/0 method- 

@Override J 

public void onSavelnstanceState(Bundle savedlnstanceState) { 


savedlnstanceState.putLong("workoutld", workoutld); 


public void setWorkout(long id) 
this•workoutld = id; 

} 














different screen s/zes 


Phowc versus tablet 

There’s one more thing we want to do with our Workout app. 
We want to make the app behave differently depending on 
whether we’re running it on a phone or a tablet. 



Create fragments 
Link fragments 
Device layouts 


On a tablet 

If we’re running the app 
on a tablet, we want it to 
look and behave how it 
does now. We want the 
list of workouts and the 
workout details to appear 
side by side in the same 
activity. When you click 
on a workout, its details 
appear alongside it. 



On a phone 

If we’re running the app on a phone, we want 
the app to behave differently. We want the list 
of workouts to appear in one activity and take 
up the full screen of the device. When you 
click on a workout, this will launch a second 
activity that displays details of the workout. 
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12:45 


The Limb Loosener 


Core Agony 
The Wimp Special 


Strength and Length 


a\rc W 

activities, catK 
ov\t disflay'mj 

•(Vdywcyrt. 



12:46 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 











fragments 


The phone awd tablet app structures 


Here’s how the tablet and phone versions of the app need to work: 

On a tablet 



Instead of using both fragments inside MainActivity, 
MainActivity will use Workout List Fragment and 
Detail Activity will use Workout Detail Fragment. 
MainActivity will start Detail Activity when the user 
clicks on a workout. 



activity—main.xml 


cLayout>| 

: /Layou-tl 

activity—detail.xml 






MainActivity.java 


Detail Activity .java 


Phone 



WorkoutList 

Fragment.java 




WorkoutDetail 

Fragment.java 


Workout.java 


: Layou^l 
: /Layou-tl 

fragment— 
workout detail.xml 


We need to get the app to look and behave differently depending 
on whether the app is run on a phone or a tablet. To help us do 
this, let’s see how we can get our app to choose a different layout 
depending on the type of device it’s running on. 
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different resources for different screens 


Put screcw-specific resources in 
screen-specific folders 

Earlier in the book, you saw how you could get different devices to use 
image resources appropriate to their screen size by putting different sized 
images in the different draw able folders. As an example, you put images 
you want devices with high density screens to use in the drawable-hdpi 
folder. 

You can do something similar with other resources such as layouts, 
menus, and values. If you want to create multiple versions of the same 
resources for different screen specs, you just need to create multiple 
resource folders with an appropriate name. The device will then load the 
resources at runtime from the folder that’s the closest match to its screen 
spec. 

As an example, if you want to have one layout for large screen devices, 
and a couple of other layouts for other devices, you put the layout for the 
large device in the app/src/main/res/layout-large folder, and the layouts for 
the other devices in the app/src/main/res/layout folder. When the app gets 
run on a device with a large screen, the device will use the layout in the 
layout-large folder: 



Create fragments 
Link fragments 
Device layouts 


app/src/main /\|| devices W\{\\ s^allcv- sdvccir>s >w*ill load 

七 layou*U -fvom -the layout -foldcv*. 

o 


These two layouts v/i" 
be used oh devils with 
srwallcv* sdvcchs. 


Lav-y devices like *t3ble*ts 



layout 


V,ll load layout ^ 


activity_main.xml 

activity_detail.xml 

a 








This layou-t will be used by 
J •” .iih a la^r^c 


On the next page, we’ll show you all the different options you can use for 
your resource folder names. 
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fragments 


The different folder options 


You can put all kinds of resources (drawables or images, layouts, menus, 
and values) in different folders to specify which types of device they 
should be used with. The screen-specific folder name can include 
screen size, density, orientation and aspect ratio, each part separated by 
hyphens. As an example, if you want to create a layout that will only be 
used by very large tablets in landscape mode, you would create a folder 
called lay out-xlarge- land and put the layout file in that folder. Here are 
the different options you can use for the folder names: 


You mus*t spcdi-fy a vcsouvtc -type- 

4 一 


Screen dc^si-ty is based 


Resource type 

drawable 
layout 
menu 
mipmap 
values 


n rwiprwap is 

used (oy appka 七 io 灼 
\Coy\s. 0\Atr vcv-siohs 
o( A^dv-oid Studio use 
dv-awablcs msicad- 


Screen size 

Screen density 

-small 

-ldpi 

-normal 

-mdpi 

-large 

-hdpi 

-xlarge 

-xhdpi 


-xxhdpi 


-xxxhdpi 


-nodpi ^ - 


-tvdpi 


Orientation 

-land 

-port 


Aspect ratio 

-long 

-notlong 

|oy>^ is -rov* styttv\s 

七 ha 七 iiave a vc\ry 
value (or height 


This is -fov* dor>s'i*ty— 
vesouvdes. Use -v>odf'i (or 叫 imay 
vesouvdes you do^*t v/3ir>*t *to sdalc 
a -foldcv* ddllcd dhrdv/dble— 
nodfi). 


Android decides at runtime which resources to use by looking for the 
best match. If there’s no exact match, it will use resources designed 
for a smaller screen than the current one. If resources are only 
available for screens larger than the current one, Android won’t use 
them and the app will crash. 

If you only want your app to work on devices with particular screen 
sizes, you can specify this in AndroidManifest. xml using the 
〈 supports-screens 〉 attribute. As an example, if you don’t 
want your app to run on devices with small screens, you’d use 

<supports-screens android : smallScreens="false" / > 

Using the different folder names, you can create layouts that are 
specific for phones and tablets. Let’s start with the tablet version of 
our app. 


^ oXt 咖⑽ 
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exercise 


m BE ih^ Sfwfure 

mt Below youll see the code for an 
IP# activity. You want to display one 
layout whenit runs on devices widi 
」 i lar^e sized screens, and 

another layout ^en 

L 辻 runs on devices widi 

normal sized screens. 

输 eh of these folder 
‘ structures will allow you to do that? 



import android.app.Activity; 
import android.os.Bundle; 


ttcv-cs i\\t activity. 


public class MainActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity main); 



app/src/main 

- — I 


res 


□ 

layout 


<%ml> j 

</ %n\\\ 


activity_main.xml 


L a 


layout-tablet 


</ %W\\\ 


activity_main.xml 


o □ 

app/src/main 

413 

res 

~o 


layout 



activity_main.xml 



layout-large-land 



activity_main.xml 
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o □ 

app/src/main 

L [f3 

res 

CZ3 


layout 



activity_main.xml 

□ 


layout-large 



activity_main.xml 


o □ 

app/src/main 

L Q 


res 



activity_main.xml 



activity_main_tablet.xml 



□ 

app/src/main 

L a 


res 


□ 

layput-large 

activity_main.xml 

413 

ayout-r 

1—Qj 

activity_main.xml 


■normal 


❾ □ 

app/src/main 

L a 


res 


□ 

layout 


1 

|</ 


activity_main.xml 

a 

layout-large-land 

1—Qj 

activity_main.xml 

layout-large-port 

~~ <%ml> I 

</ %vr\\\ 

activity_main.xml 
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solution 



BE{h^ Sfmcfure §©lug©n 

Below you’ll see the code for an 
activity. You want to display one 
layout ^viienit runs on devices widi 
, i lar^e sized screens, and 

another layout ^en 
it runs on devices wilh 
smaller sized screens. 

■ of these folder 

structures will allow you to do that? 


import android.app.Activity; 
import android.os.Bundle; 


public class MainActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity main); 


o 


app/src/main 
-一 


X 


res 


A^dv-oid doesn't 
rcdo^hiz^ -foldcv 
layou*t-*tablrt. 

七 he layout -folder will 
be displayed oy \ all 
devidcs. 


layout 




activity_main.xml 

-二 

layput-tablet 

activity_main.xml 



A devide wi*th a lav^c 

sdrcch y/ill use layout 

•m layou-t-lav-^c-la^d 

-folder y/hch i*t’s orierrted 
la^dsdape- W\\cy\ -the device 
is \ro*ta*ted *to po\rtv-ai*t, i*t 
will use *tKc layout m 

layout -folder. 


res 



layout 


</%rr »|4 


activity_main.xml 




layout-large-land 




activity_main.xml 
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fragments 


res 


O □ 

app/src/main 

L Q 

Divides y/i*th d large 
sdrcch will use 

layout m -the layou*t- 
largc -folder. Divides 
wi*th smaller sdvcchs 
will use *thc layout m 
*tKc layou*t -folder. 



□ 

layout 

■ <%ml>l 
</ 

activity_main.xml 

□ 

layout-large 

<%ml> I 

</>cm|^ 

activity—main.xml 


❺ aPP EL n X 


res 


The ad*tivi*ty uses a 

layout -file called 
The layout ad*tivi*ty_ 
wor /七 be used. 


layout 


<%r»»l> I 
</X.m|i 


activity_main.xml 


|</>cm|i 


activity—main_tablet.xml 


@ □ 

app/src/main 

L Q 


x 


O 



Devices wi*th a lav^c re 

S 

CZ3 

layout-large 

Devices \wi*tK a lav-gc 

sdrcch will use 

sdrcch will use *thc 

layout m layout- 

1—Qj 

activity main.xml 

layout *m -the layou*t- 

lav-gc -folder. Divides 

largc-la^di -foldcv when 

y/i*th normal sdrcchs 

L ri 

*tKc devide is *tu\nr\cd 

will use layou*t 

layout-normal 

1—Qj 

|<"rj 彳 

la^dsdape) a^d the 

•m layou 七一 hormal 

layout *m -the layou*t- 

-folder. There’s r\o 
layou*t -for devices 
wi*th B small sd\rccr\, so 
■they y/or /七 be able *to 
ruh app. 

activity_main.xml 

lav-y—po\rt -folder whch 
the device is *tu\rhcd 
po\rbrai*t. 0*thcv divides 
will use -the layout *m 
•the Uyou*t -folder. 


res 


layout 

activity_main.xml 

□ 

layout-large-land 

activity_main.xml 

□ 

layout-large-port 

~~ <>Cr^l>j 

activity_main.xml 
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layout-large 


Tablets use layouts in the layout-large folder 



Create fragments 
Link fragments 
Device layouts 


Getting the tablet version of our app up and running is easy — all we need 
to do is put our existing activity layout file activity—main.xml into the app/ 
sre/main/res/layout-large folder. The layout in this folder will then only be 
used by devices with a large screen. 

If the app/sre/main/res/layout-large folder doesn’t exist in your Android 
Studio project, you’ll need to create it. To do this, switch to the Project 
view of your folder structure, highlight the app/sre/main/res folder in the 
folder explorer, and choose Fileew... irectory. When prompted, 

give the folder a name of “layout-large”. When you click on the OK 
button, Android Studio will create the new app/sre/main/res/layout-large 
folder for you. 


To copy the activity—main.xml layout file, highlight the file in the explorer, 
and choose the Copy command from the Edit menu. Then highlight the 
new layout-large folder, and choose the Paste command from the 
Edit menu. Android Studio will copy the activity—main.xml file into the app/ 
sre/main/res/layout-large folder. 

If you open the file, it should look like this: 



Workout /AndroidStudioProj 

► Cl. idea I 

▼ C®app 
► Clbufld 

Cl libs I 

▼ Cl sre 

► Q androicJTest A 

w Q main ■ 

java 1 


Cares 

drawable 


lay 




layout-large , 
a^jLirih.r rn 


<?xml version= M 1.0" encoding= M utf-8"?> 

〈LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
android : orientation= M horizontal" 


android : layout—width= n match—parent" 
android : layout—height= n match—parent n > 


<fragment 


□ 

Workout 

L Q 


class="com.hfad.workout.WorkoutListFragment 
android : id="@+id/list_frag" 
android : layout_width="Odp" 
android : layout_weight="2" 
android:layout height="match parent" / > 


<FrameLayout 


i\\t layout jus 七 
Co?\tA i*b "to 


app/sre/main 


res 


I 

- 1 


Copied »*C to xnc layout-large 

layout-lav-jc \o\dtr. —|_ rh 

activity_main.xml 


android : id="@+id/fragment_container" 
android : layout_width= M Odp" 
android : layout_weight="3" 
android : layout—height= n match—parent" / > 
</LinearLayout> 


This layout will be used by devices with a large screen, so when the app is 
run on a tablet, the two fragments will be displayed side by side. Next, let’s 
deal with the phone layouts. 
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The MaiwActivity phone layout 

When the app runs on a phone, we want Main Activity 
to just display Workout List Fragment, and not 
Workout Detail Fragment. To do this, we’ll update the code 
in activity—main, xml’m the app/sre/main/res/layout folder so that it 
just contains Workout List Fragment. Any phones that run 
the app will use the layout in the layout folder, whereas any tablets 
will use the layout in the layout-large folder. 

To do this, open the activity—main, xml file in the app/sre/main/res/ 
layout folder, then replace the XML with the code below: 


12:45 



<?xml version="l.0" encoding= M utf-8 M ?> 

<fragment xmlns : android:’▼ http://schemas.android.com/apk/res/android" 
class= n com.hfad.workout.WorkoutLis tFragment n 
android:id= n @+id/list frag" 

yyiorv 

android: layout_width= M match_^parent M | 「— | 

android: layout 一 heigh t= n match_parent n /> app/sre/main 

L a 


Workout 




Make su^rc you edit adivi 七 
,h layout -foldcv-. 


res 


As MainActivity only needs to display 

Workout List Fragment when it’s running on a phone, there’s 
no need for us to create a separate layout that contains the 
<f ragment> element. This is only necessary when you need to 
display multiple fragments. 

Note that the version of activity—main, xml in the layout folder 
doesn’t contain the f ragment_container frame layout, 
whereas the version of activity_main.xml in the layout-large folder 
does. This is because only the version of activity—main, xml in the 
layout-large folder needs to display Workout Detail Fragment. 
Later on, we’ll be able to use this fact to figure out which layout 
the app’s using on the user’s device. 

The next thing we need to do is create a second activity that uses 
WorkoutDetailFragment. 



</ 


activity_main.xml 




To get our app to 
look different on a 
phone and a tablet, 
we’re juggling two 
different layouts 
with the same 
name. 


Take the next few pages slowly, and 
double-check you’re updating the 
correct version of the layout. 
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create DetailActivity 


Create fragments 
Link fragments 
Device layouts 

to display details of the workout 


Phones will use PctailActivity 


V 

\/ 


We’re going to create a second activity called DetailActivity. This 
activity will contain Workout Detail Fragment, and will be used by 
phones to display details of the workout the user selects. 


Use the Android Studio New Activity wizard to create a new blank activity 
called D etailActivity.java with a layout called activity_detail, xml. This layout 
needs to be in the app/sre/main/res/layout folder so that any device can use it. 


The layout just needs to contain the fragment WorkoutDetail Fragment. 
Update the code in activity_detail.xml as follows: 


□ 

Workout 

L Q 

app/sre/main 

L D 


res 



<?xml version="l.0" encoding= M utf-8"?> 

<fragment xmlns : android="http : //schemas.android.com/apk/res/android" 


activity_detail.xml 


class="com.hfad.workout.WorkoutDe tailFragment' 
android:id= n @+id/detail 一 frag n 
android:layout_width="match_parent M 
android:layout_height= n match_parent"/> 


As well as updating the activity_detail layout, we need 
to update DetailActivity itself. If the app is 
running on a phone, Main Activity will need to start 
DetailActivity using an intent. This intent will need 
to include the ID of the workout the user has selected as 
extra information. The DetailActivity will then 
need to pass this to the WorkoutDetail Fragment 
using its setWorkout () method. 


^ - will display 

\P 


12:46 



Intent 



MainActivity 


DetailActivity 



WorkoutDetailFragment 


\ t 

Wc r\ttA *to update ad*twi*t»cs. 

v/’rth Pct3>1 
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P00] Puzz]c 


Your job is to take code segments from the 
pool and place them into the blank lines 
in DetailActivity.java. You may not use 
the same code segment more than 
once, and you won’t need to use all 
the code segments. Your goal is to get 
the workout ID from the intent, and 
pass it to WorkoutDetailFragment. 


package com.hfad.workout; 


import android.app.Activity; 
import android.os.Bundle; 

public class DetailActivity extends Activity { 

public static final String EXTRA—WORKOUT_ID = 

QOverride 


usmj a -Pov 七 he 

o( -the 

•m 七 he m 七 e 灼七 so ihai wc k^ow 
Maiir>A^tivi-ty ar\d DctailA^tivi-ty 
usrnj -the same 


protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—detail); 

WorkoutDetailFragment =( ) 

(R.id.detail_frag); 

int workoutld = (int) getlntent() .getExtras() •get(EXTRA—WORKOUT—ID); 
WorkoutDetailFragment.setWorkout(workoutld); 
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Paa] puzzjc §a]ufian 

Your job is to take code segments from the 
pool and place them into the blank lines 
in DetailActivity.java. You may not use 
the same code segment more than 
once, and you won’t need to use all 
the code segments. Your goal is to get 
the workout ID from the intent, and 
pass it to WorkoutDetailFragment. 


package com.hfad.workout; 



Create fragments 
Link fragments 
Device layouts 


import android.app.Activity; 
import android.os.Bundle; 

public class DetailActivity extends Activity { 

public static final String EXTRA—WORKOUT—ID = "id"; 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—detail); 

WorkoutDetailFragment WorkoutDetailFragment = ( WorkoutDetailFragment ) 

getFragmentManager() . findFragmentByld (R. id. detail frag); 
int workoutld = (int) getlntent() .getExtras() •get(EXTRA—WORKOUT—ID); 
WorkoutDetailFragment.setWorkout(workoutld); 


Wc yt a v-c-fcvchtc *to a -frajmcrj-t 

by s 

-fI ) method. 
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The full PetailActivity code 


Here’s the full code for Detail Activity (replace the code 
Android Studio has generated for you with the code below): 

package com.hfad.workout; 

import android.app.Activity; 
import android.os.Bundle; 

public class DetailActivity extends Activity { 

public static final String EXTRA 一 WORKOUT—ID = 

@Override 


□ 

Workout 

L a 

app/sre/main 

L Q 


java 



com. hfad. workout 

O 

DetailActivity.java 


6 fd a reference 

.■to 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

setContentView(R.layout.activity—detail); 背 , 

WorkoutDetailFragment workoutDetailFragment = (WorkoutDetailFragment) 
getFragmentManager().findFragmentById(R.id.detail 一 frag); 
int workoutld = (int) getlntent().getExtras()•get(EXTRA—WORKOUT 一 ID); 
workoutDetailFragment.setWorkout(workoutld); 


Pass *tV)c y/ov"koiA*t IP *to *bV)C 七 . 


"the ID o-P "the v/ov*kou*t the 

use\r disked o 灼 -Pv-orw -the … 七⑶七 . 


The Detail Activity code gets the ID of the workout from 
the intent that started the activity. The next thing we need to do 
is get MainActivity to start Detail Activity — but only if 
the app’s being run on a phone. 

But how can we tell? 
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which layout 


Use layout differences to tell which 
layout the device is using 


V 

\/ 


Create fragments 
Link fragments 
Device layouts 


We want Main Activity to perform different actions when the user 
clicks on a workout depending on whether the device is using activity— 
main, xml in the layout or lay out-large folder. 


If the app is running on a phone, the device will be using 
activity_main.xml in the layout folder. This layout doesn’t 
include WorkoutDetailFragment, so if the user 
clicks on a workout, we want MainActivity to start 
Detail Activity. 


If the app is running on a tablet, the device will be using 
activity_main.xml in the layout-large folder. This layout includes 
a frame layout with an ID of fragment—container that’s 
used to display WorkoutDetailFragment. If the user clicks 
on a workout in this case, we need to display a new instance of 
WorkoutDetailFragment in the fragment_container 
frame layout. 




The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 


The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 
15 Pull-ups 


layoiA-b 

\v\ 


•(Vayweirrb 一乙 cw*tai 

•m /一州啪 1 

layou-b-lary -folder. 



We can deal with both these situations in MainActivity by checking 
which layout the device is using. We can tell this by looking for a view 
with an ID of f ragment_container. 

If f ragment_container exists, the device must be using activity—main, 
xml in the layout-large folder, so we know we have to display a new 
instance of WorkoutDetailFragment when the user clicks on a 
workout. If fragment—container doesn’t exist, the device must be 
using the version of activity_main.xml in the layout folder, so we need to 
start Detail Activity instead. 
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The revised MaiwActivity code 


Here’s the full code for MainActivity.jam (update your code with 
our changes): 


package com.hfad.workout; 


import 

import 

import 

import 

import 


android.app.Activity; 

android.app.FragmentTransaction; 


android.content.Intent; 


android.os.Bundle; 

android.view.View; 


usmj -these wbra classes 
•m the i-tcrwCli^kcdO mcihod- 


□ 

Workout 

L Q 

app/sre/main 

L D 



com. hfad. workout 


PoT{| 

a 

MainActivity.java 


public class MainActivity extends Activity 

implements WorkoutListFragment.WorkoutListListener { 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


super.onCreate(savedlnstanceState); 


setContentView ( R . layout . activity — main ); 

} a -to -fv-amc layout femtams 

TV^*»s will aff 

@ Override \s r\AV\ oy\ d d lary screen . 

public void itemClicked(long id ) { 

View fragmentContainer = findViewByld(R.id.fragment—container); 
if (fragmentContainer != null) { 

WorkoutDetailFragment details = new WorkoutDetailFragment (); 
FragmentTransaction ft = getFragmentManager (). beginTransaction (); 
details . setWorkout ( id ); 

ft . replace ( R . id . fragment — container , details ); 
ft . addToBackStack ( null ); 

ft . setTransition (FragmentTransaction . TRANSIT — FRAGMENT 一 FADE ) ,• 
ft.commit (); 


l/Vlc ov\\y y\tt& 
"to "this 
CoAt i-f "the 
-fv-amc layou-t 
is 




} else { 


Intent intent = new Intent(this, DetailActivity.class); 
intent.putExtra(DetailActivity.EXTRA 一 WORKOUT—ID, (int)id); 
startActivity(intent); 

|-f -fvamc layout -thcv-c, the app mus 七 be 

Ol^ d v/rth 3 SirwdllcV" 七 

DeiailM 七〜士 Y, fassm^ *i*t i\\t IP o-f i\\t v/o\rkout 


Let’s see what happens when we run the app. 
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test drive 

Test drive the app 



Create fragments 
Link fragments 
Device layouts 


When you run the app on a tablet, it appears just as before. A list 
of the workout names appears on the left of the screen, and when 
you click on one of the workouts, its details appear on the right. 



When you run the app on a phone, the list of workout names 
appears on the screen. When you click on one of the workouts, its 
details are displayed in a separate activity. 


The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 

you \-[av\ -the dpp oy\ 
3 ihc app looks 

displays a si^lc ad-tivi-ty... 
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12:46 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 

… you tl’idk oy> d y/ovkout 
details o-f y/ovkou*t av-c 
d'isf>ldyed m a sepavate adtiv’rb/. 



















fragments 



Your Android Toolbox 

You’ve got Chapter 7 under 
your belt and now you’ve 
added fragments to your 
toolbox. 


BUL1ET POINTS 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


A fragment is used to control 
part of a screen. It can be 
reused across multiple 
activities. 

A fragment has an associated 
layout. 

A fragment is a subclass 

of the android.app. 
Fragment class. 

The onCreateView() 

method gets called each time 
Android needs the fragment’s 
layout. 

Add a fragment to an 
activity’s layout using the 
<f ragment> element and 
adding a class attribute. 

The fragment lifecycle 
methods tie in with the states 
of the activity that contains the 
fragment. 

The Fragment class doesn’t 
extend the Activity class 
or implement the Context 
class. 


■ 


■ 


■ 


■ 


Fragments don’t have a 
f indViewByld () method. 
Instead, use the getview () 
method to get a reference to 
the root view, then call the 
view’s f indViewByld () 
method. 

A list fragment is a fragment 
that comes complete 
with a Listview. You 
create one by subclassing 

List Fragment. 

If you need to get a fragment 
to respond to changes in 
the user interface, use the 

<FrameLayout> element. 

Use fragment transactions to 
make a set of changes to an 
existing fragment and add to 
the back stack. 

Make apps look different on 
different devices by putting 
separate layouts in device- 
appropriate folders. 


Fragment Lifecycle Methods 


onAttach() 


onCreate() 


onCreateView() 


onActivityCreated() 


onStart() 


onResume() 


onPause() 


onStop() 


on Destroy View() 


on Destroy () 


You CBy\ download 
-full todt -for 

Wt 七尸 : //Uy^*Uo 眯 / 

Headers 七 


onDetach() 


CHAPTER 7 
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8 nested fr^ments 


參 Dealing with Children ♦ 



You’ve seen how using fragments in activities allow you to 
reuse code and make your apps more flexible. 

In this chapter, we re going to show you how to nest one fragment inside another. 
You’ll see how to use the child fragment manager to tame unruly fragment transactions. 
Along the way you’ll see why knowing the differences between activities and 
fragments is so important. 


this is a new chapter 
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nested fragments 


Creating nested fragments 


In Chapter 7, you saw how to create fragments, how to include them in 
activities, and how to connect them together. To do this, we created a list 
fragment displaying a list of workouts, and a fragment displaying details of a 
single workout. 

It’s not just activities that can contain fragments — fragments can be nested 
inside other fragments. So that you can see this in action, we’re going to add a 
stopwatch fragment to our workout detail fragment. 


The Limb Loosener 


Core Agony 


The Wimp Special 


Strength and Length 


toK\*ba'ms a list ok 

y/o\rkou*bs* 


me wimp special 

5 Pull-ups 
10 Push-ups 
15 Squats 


0 : 00:00 




Wov-kou*tPc*ta'ilFv-a5mcr>*t 
displays details -the 
>wov-kou*t usev dlidks OY\- 

gomg -to add a 

"to 

IVoirkou-tDc-tailFv-agrhCh-t. 


Well add a new stopwatch fragment 

We’re going to add a new stopwatch fragment 
called StopwatchFragment.java that uses a layout 
called fragment_stopwatch. xml. WeVe going to base 
the fragment on the stopwatch activity we created 
back in Chapter 4. 

We already know that activities 
and fragments behave in similar 
ways, but we also know that a 
fragment is a distinct type of 
object — a fragment is not a 
subclass of activity. Is there 
some way we could rewrite 
that activity code so that it 
works like a fragment? 





Tablet 


: Layou^l 
: /Layout! 


Wt tv-caicd 
all o( -these \v\ 

Chapicv- 7 . 


activity—main.xml 



MainActivity.java 



WorkoutList 

Fragment.java 



WorkoutDetail 

Fragment.java 
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fragment— 

stopwatch.xml 


Stopwatch 
Fragment.java 


fragment— 
workout detail.xml 


l/Vc II dvca*tc 
a^d i*ks layout 
























nested fragments 


Fragments and activities have similar lifecycles. 

To understand how to rewrite an activity as a fragment, we 
need to think a little about the similarities and differences 
between them. If we look at the lifecycles of fragments and 
activities, we’ll see that they’re very similar: 


Lifecycle Method 

Activity? 

Fragment? 

onAttach() 


n/ 

onCreate() 

n/ 

n/ 

onCreateView() 


n/ 

onActivityCreated() 


n/ 

onStart () 

n/ 

n/ 

onPause() 

n/ 

n/ 

onResume() 

s/ 

n/ 

onStop() 

n/ 

n/ 

onDestroyView() 


n/ 

onRestart() 

n/ 


onDestroy() 

\/ 

n/ 

onDetach() 


n/ 


...but the methods are slightly different 

Fragment lifecycle methods are almost the same as activity lifecycle 
methods, but there’s one major difference: activity lifecycle 
methods are protected and fragment lifecycle methods are 
public. And we've already seen that the way fragments create a 
layout from a layout resource file is different. 

Also, in a fragment, we can’t call methods like f indViewByld () 
directly. Instead, we need to find a reference to a View object, and 
then call view. f indViewByld () • 

With these similarities and differences in mind, it’s time you started 
to write some code... 
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exercise 


Cf c ^rpen your pencil 


This is the code for StopwatchActivity we wrote earlier. You’re going 
to convert this code into a fragment called StopwatchFragment. With 
a pencil, make the changes you need. Keep the following things in mind: 

- Instead of a layout file called activity_stopwatch.xml, it will use a layout called 

fragment_stopwatch. xml. 

- Make sure the access restrictions on the methods are correct. 

- How will you specify the layout? 

-The runTimer () method won’t be able to call f indViewByld (), so 
you might want to pass a view object into runTimer (). 


public class StopwatchActivity extends Activity { 

/ /Number of seconds displayed on the stopwatch. 

private int seconds = 0; ^ — scfi-Ohds passed- 

//Is the stopwatch running? 


private boolean running; 


-uhhmg says the siopwatdh is …⑽叫 

private boolean wasRunning; wasKuhhihg says whether the was 乂 “ 


@Override 


a j 「 厂 wercen 

bcW the st>py/a-Uh was paused. 




protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_stopwatch); 
if (savedlnstanceState != null) { 

seconds = savedlnstanceState•getlnt("seconds n ); 
running = savedlnstanceState•getBoolean("running"); 
wasRunning = savedlnstanceState•getBoolean("wasRunning ，'）； 
if (wasRunning) { 
running = true; 


|.f adtWity was destroyed 

代一 treated, v-csW 

state variables 

savedBundle. 


runTimer () ; - S*t3\r 七 * ^u^Tn^cvO method* 


QOverride 

protected void onPauseO { the i-f the activity is 

super.onPause(); 
wasRunning = running; 
running = false; 
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protected void 

super.onResume(); 
if (wasRunning) { 


@Override 



Starts 士 ) a 4 w 士 / ⑽ 


running = true; 



Save -the a^iiviiy^s s-ta-tc bc-fovi 
"the adiivi-ty is des-tv-oyed- 


©Override 


protected void onSavelnstanceState(Bundle savedlnstanceState) { 

savedlnstanceState .putlnt (’'seconds ， ' ， seconds); 
savedlnstanceState • putBoolean ( "running’ ，， running); 
savedlnstanceState • putBoolean ( ， ’ wasRunning" , wasRunning); 

} 

public void onClickStart(View view) { 
running = true; 



public void onClickStop(View view) 
running = false; 


public void onClickReset(View view) 
running = false; 
seconds = 0; 


Wsc a tta^dlcv- -fco post Code {o 

七 he r>urwbcv* o( sedo^ds and 

updaic 七 he view cvcvy stCov\d- 



private void runTimer() { y 

final TextView timeView = (TextView) findViewByld(R•id•time—view); 
final Handler handler = new Handler(); 
handler.post(new Runnable() { 


QOverride 

public void run() { 

int hours = seconds / 3600; 

int minutes = (seconds % 3600) / 60; 

int secs = seconds % 60; 

String time = String.format("%d:%02d:%02d M f 


hours, minutes, secs); 


timeView.setText(time); 
if (running) { 


seconds++; 


handler.postDelayed(this f 1000); 
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solution 


cfQSterpen your pencil 


"This is the hew h^r^e- 


This is the code for StopwatchActivity we wrote earlier. You’re going 
to convert this code into a fragment called StopwatchFragment. With 
a pencil, make the changes you need. Keep the following things in mind: 

- Instead of a layout file called activity_stopwatch.xml, it will use a layout called 

fragment_stopwatch. xml. 

- Make sure the access restrictions on the methods are correct. 

- How will you specify the layout? 

-The runTimer () method won’t be able to call f indViewByld (), so 
you might want to pass a view object into runTimer (). 


public class extends { 

/ /Number of seconds displayed on the stopwatch. 

private int seconds = 0; WcVc C%*tcir\dm5 

//Is the stopwatch running? 
private boolean running; 
private boolean wasRunning; 

^ n w^TKis mc*tKod v>ccds *to be Publ'id. 

@Override 

public void onCreate (Bundle savedlnstanceState) { 
super .onCreate (savedlnstanceState) ; /i^^/o\A dor^i set 3 -fva^mc^s layout 

• — " O ^ •• 灼 •• 七 ^ 七 〆) rwet^od. 

if (savedlnstanceState != null) { 

seconds = savedlnstanceState•getlnt("seconds"); 
running = savedlnstanceState • getBoolean (’’running"); 
wasRunning = savedlnstanceState•getBoolean( n wasRunning n ); 
if (wasRunning) { 

running = true; ^ ^ | cavc ^ |S do dc m iht oX^itO me 栎 od. 

} 

⑽ 七 vuhTirwcv-0 yc*t bedduse we’v/e 

} ⑽七试七 "the layou-t—we doy\{, have a^y views ye 七 . 

^Override Wc set tV^c layout *m 

public \/iew or\Cv-ca*tc\/iew(Layou*t|h-fla*tcv , m-fla-tcr, \/iev^roup dorrtaiw, *bV)C o^Cv-catcVic^wO w>c*t^od- 

Bundle savedl^s*tahdeS*ta*te) { 

\/iew layout ― layoutdoh-tamev-, -false); 

—& SS 七 ^ view -to -the nmTWvO mc-thod. 


^Ti^is mc*tV>od y>ccds *to be fublid. 

@Override 

fublid void onPause () { 

super.onPause(); 
wasRunning = running; 
running = false; 
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。一 ■ d k,TIVis method Y\ttds b> be fublit- 

@ Override 

^AZNfe^ener^d\ fublid void onResume () { 

super.onResume(); 
if (wasRunning) { 
running = true; 


QOverride 



^This me 七 hod y>ccds *fco be fublid. 

fublid void onSavelnstanceState (Bundle 


savedlnstanceState) 


savedlnstanceState .putlnt (’'seconds ， ' ， seconds); 
savedlnstanceState • putBoolean (▼ ， running" , running); 
savedlnstanceState•putBoolean( n wasRunning n , wasRunning); 


public void onClickStart(View view) 
running = true; 

} 

public void onClickStop(View view) 
running = false; 

} 


public void onClickReset(View view) { 
running = false; 
seconds = 0; 

} ^Timc\rO mcihod r>ow -takes a \/icw. 

private void runTimer ( view view ) { 

final TextView timeView 二 (TextView) view, findViewByld (R .id•time_view); 

final Handler handler = new Handler (); ^ Msc ^ ^ ? ara^titr bo dall ^md\/*.Cv/BylaO. 

handler.post(new Runnable() { 

QOverride 

public void run() { 

int hours = seconds / 3600; 

int minutes = (seconds % 3600) / 60; 

int secs = seconds % 60; 

String time = String.format("%d:%02d:%02d M f 
hours, minutes, secs); 
timeView.setText(time); 
if (running) { 
seconds++; 

} 

handler.postDelayed(this f 1000); 

} 

})； 
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StopwatchFragment code 


The StopwatchFragmcwt code 

We’ll add StopwatchFragment to our Workout project so that we can 
use it in our app. You do this in the same way you did in Chapter 7. Go to 
File^-New...^Fragment^-Fragment (Blank). Give the fragment a name of 
“StopwatchFragment”，a layout name of “fragment—stopwatch”，and untick the 
options for including fragment factory methods and interface callbacks. 


When you click on the Finish button, Android Studio creates a new fragment for 
you in a file called StopwatchFragment.java in the app/sre/main/java folder. Replace 
the fragment code Android Studio gives you with the following code (this is the 
code you updated in the exercise on the previous page): 


package com.hfad.workout; 


import 

import 

import 

import 

import 

import 

import 


android.os.Bundle; 
android. os• Handler; 
android.app.Fragment; 
android.view.Layoutlnflater; 
android.view.View; 
android.view.ViewGroup; 
android.widget.TextView; 


public class StopwatchFragment extends Fragment 



Workout 


H7~l 

app/sre/main 


java 


com. hfad. workout 

Stopwatch 

Fragment.java 


/ /Number of seconds displayed on the stopwatch. 

private int seconds = 0; ^ —〜 The humbev" o( setohds *tWt passed- 


//Is the stopwatch running? 


private boolean running; 


says the is 


J w is ruhhihA* 

private boolean wasRunning ; 十 wasKuhhihg says v/hclhcv- ihc was 乂 叫 

bcW the st>py/a-tdh was paused. 3 


@Override 


public void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 
if (savedlnstanceState != null) { 


RcsW state o( variables 

savedBundle. 


seconds = savedlnstanceState•getlnt("seconds n ); 
running = savedlnstanceState • getBoolean (▼ ， running"); 
wasRunning = savedlnstanceState•getBoolean( n wasRunning ，'）； 
if (wasRunning) { 


running = true; 
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The StopwatchFragmcwt code (continued) 


QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inflater.inflate(R.layout.fragment_stopwatch, container, false) 
runTimer (layout) ; layout st^rt 七 ^ 


return layout; 


•^T'lmcrO method fassmj *m layout- 


@Override 

public void onPause() { 

super.onPause (); 
wasRunning = running 
running = false; 

} 

QOverride 

public void onResume() 
super.onResume(); 
if (wasRunning) { 
running = true; 

} 

} 



the -Pirag^ch-ts paused ； 
^oyA whcthcir the s-topwa-Uh 
was \TUhhihg ay\d s-top it. 





Workout 


l-f stopwaUV) was \rurmm3 bc-fo^rc it 
y/ds paused, sc-t i-t aja'm. 


L Q 


app/sre/main 



java 


com. hfad. workout 

Stopwatch 

Fragment.java 


QOverride 

public void onSavelnstanceState(Bundle savedlnstanceState) 
savedlnstanceState.putlnt("seconds ", seconds); 
savedlnstanceState • putBoolean (’'running ， ' ， running); 


{ Pu*t values o-f "tKc 

^_enables ih the Bundle 

^ ^ — bc-Po\rc the adtivi-ty is 

0 ^ dcs-fciroycd- These av-c 

savedlnstanceState•putBoolean( n wasRunning n , wasRunning); ㈣ 一 “‘ 巧、+}广 s 

tu\rhs the device. 


public void onClickStart(View view) 


running 


true 


TVis Codt needs *to 4 ⑼ the user 
c]\cks OY\ ■b^c S*ta\rt button. 


TV^c todt 6or\tmuCS 

OY\ ■(Jie wt pay. 
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code continued 


The StopwatchFragmcwt code (continued) 


public void onClickStop(View view) 


□ 


running = false; 


TV^IS CoAt r\ccds *to r\AY\ 仏⑼ usev 
乙 kks cm S*tof 


Workout 



public void onClickReset(View view) { 
running = false; "V 

This Code i^eeds -fco v*uk> when -the usev- 
di 匕 ks oh 七 he Rcsci bu-t-to^. 


app/sre/main 

Z3 



seconds 


0; 


i\\t todt m d ttav>dlcv *i*t 

tdiY\ v-uy> m 七 he badk^vouy>d *thv-cad- 


private void runTimer(View view) { 

final TextView timeView = (TextView) view•findViewByld(R.id•time—view); 
final Handler handler = new Handler(); 
handler.post(new Runnable() { 

QOverride 

public void run () { 

int hours = seconds / 3600; 
int minutes = (seconds % 3600) / 60; 
int secs = seconds % 60; 

String time = String.format( "%d: %02d:%02d" f 
hours, minutes, secs); 

timeView.setText(time); ^^pisplay r\uw»bcv* of sttoY\d^ 七^七 

if (running) { 


java 


com. hfad. workout 

<>«" F »«{1 

Stopwatch 
Frag merit.java 


V^ave passed m s*tofwa*t^Vv 


seconds siopwa^h is \ruhhi，the humbev- o-f sedohds. 


handler.postDelayed(this f 1000); 


})； 


Rw tta^alcv code every 


That’s all the Java code we need for our 

StopwatchFragment. The next thing we need to do is say 
what the fragment should look like by updating the layout code 
Android Studio gave us. 
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The StopwatchFragmcwt layout 

We’ll use the same layout for StopwatchFragment as we 
used in our original Stopwatch app. Replace the contents of 
fragment_stopwatch. xml with the code below: 


<?xml version="1.0" encoding= M utf-8"?> 

<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android' 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout 一 width= n match 一 parent，’ 
android : layout height="match parent n > 


□ 


Workout 


d^d seconds i\\ai Kavc passed- 


<TextView 

android : id= M @ + id/time_view" 
android : layout—width= ， 'wrap_content n 
android : layout—height= n wrap—content ，’ 
android : layout_alignParentTop= M true" 
android : layout_centerHorizontal= M true" 
android : layout_marginTop="Odp" 
android : text="" 

android : textAppearance="?android:attr/textAppearanceLarge 
android : textSize= M 92sp" / > 

<Button 

android:id= M @+id/start button 
android:layout—width= n wrap_content 
android : layout—height= n wrap—content 
android : layout_below="@+id/time_view 
android : layout centerHorizontal= M true 
android:layout_marginTop="20dp 
android : onClick="onClickStart" 
android : text="@string/start" / > 

The Stav-t bu-ftoh 

<Button 

android : id="@+id/stop_button" 
android : layout—width= n wrap_content 
android : layout—height= n wrap_content 
android : layout_below= n @+id/start_button 
android : layout_centerHorizontal= M true 
android : layout_marginTop="lOdp 
android : onClick="onClickStop M 
android : text="@string/stop" / > 


L Q 

app/sre/main 


res 


□ 

layout 

■ <%nx\> I 

</%mll 

fragment— 
stopwatch.xml 
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layout continued 


The StopwatchFragmcwt layout (continued) 


<Button 

android:id="@+id/reset_button" 



T\\t Reset 灼 


android:layout_width= M wrap_content" 
android: layout—height 二 n wrap_content，' 
android: layout_below= M @+id/stop 一 button，' 
android:layout_centerHorizontal= M true" 
android:layout_marginTop="10dp" 
android:onClick= M onClickReset n 


android:text= M @string/reset" / > 
</RelativeLayout> 


The StopwatchFragmewt layout uses String values 

The XML code in fragment_stopwatch. xml uses string values for the text 
on the Start, Stop, and Reset buttons. We need to add these to strings, 
xml: 


<string 

<string 

<string 


name= n start">Start</s tring> 
name= n stop">Stop</s tring> 
name= n reset M >Reset</string> 



These a\rc 七 he 
bu-t-feo^ labels. 


The Stopwatch fragment looks just like it did when it was an activity. 
The difference is that we can now use it in other activities and 
fragments. 



The next thing we need to do is display it when we show the user 
details of the workout they choose. 



app/sre/main 



strings.xml 
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nested fragments 


Adding the stopwatch fragment to 
WorkoutPctailFragmcwt 


We’re going to add the StopwatchFragment inside 
the WorkoutDetailFragment. The user interface of 
MainActivity on a tablet will link together like this: 


dcmta’ms 



Wc need to add it programmatically 

You’ve seen that there are two ways of adding a fragment, using a 
layout file and writing J 仰 a code. If you add a fragment to another 
fragment’s layout the result can be flaky, so we’re going to add the 
StopwatchFragment to the WorkoutDetailFragment 
using Java code. That means we’re going to do it in almost the 
same way that we added the WorkoutDetailFragment to 
the activity. There’s just one difference which we’ll come to. 


II you nest fragments 
insicte fragments ， 


you need to add tke 
nestect fragment 
programmatically. 
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add frame layout 


Add a FramcLayout where the 
fragment should appear 

As you saw in Chapter 7, to add a fragment programmatically 
using Java code, you add a frame layout to your layout where 
you want the fragment to go. 

We want to put our StopwatchFragment in 
WorkoutDetailFragment underneath the workout name 
and description. We’ll add a frame layout underneath the 
name and description text views that will be used to contain 
StopwatchFragment: 


□ 


Workout 


L Q 

app/sre/main 


res 


□ 

layout 


</ 

fragment— 
workout detail.xml 


<?xml version= M 1.0" encoding= M utf-8"?> 

<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
android : layout—height= n match—parent，' 
android : layout—width= ， 'match—parent” 
android : orientation= M vertical，▼> 


<TextView 

android : layout_width=' ， wrap—content，' 
android : layout_height= n wrap_content" 

android : textAppearance= M ?android : attr/textAppearanceLarge 
android : text="" 


android : id="@+id/textTitle" / > 


<TextView 


android : layout_width= M wrap_content 
android : layout_height= n wrap_content" 
android : text="" 

android : id="@+id/textDescription" / > 


<FrameLayout 

android:id= n @+id/stopwatch 一 container" 
android: layout_width="match_^parent M 
android: layout_height= n match_parent n /> 

</LinearLayout> 

Now that we’ve added the frame layout to the layout, we need 
to add the fragment to it in our Java code. 



The Limb Loosener 

5 Handstand push-ups 
10 1-legged squats 
15 Pull-ups 


Tii'is is *tV)C 

pv-amcLayou-t 

we’ll 
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nested fragments 


Thcw display the fragment iw Java code 


We want to add StopwatchFragment to the frame layout 


when Workout Detail Fragment’s view gets created. We’ll 
do this in a similar way to how we did in Chapter 7, by replacing 
the fragment that’s displayed in the frame layout using a fragment 
transaction. Here’s a reminder of the code we used in Chapter 7: 




3 o-f 

-fv-ajw'cn't you W\s\\ *to display* 


WorkoutDetailFragment details = new WorkoutDetailFragment(); S-tav-t 七 he 

FragmentTransaction ft = getFragmentManager () . beginTransaction () ; < 

, a . . 灼 sadio 灼 . 

ft. replace (R. id. fragment_contamer,, details) ; Replan x，^e dr>d 

ft.addToBackStack(null); ^ 一 " - - - 一 add i*t *to i\\t badk slack. 


ft•setTransition(FragmentTransaction•TRANSIT—FRAGMENT—FADE) ; ^ — 

ft. commit () ; Commit braY\sat{ ： \OY\. ^agrhChts -fco ^de ih 


We used the above code to replace the fragment that’s displayed 
in an activity, but this time there’s a key difference. Instead of 
replacing the fragment that’s displayed in an activity ， we want to 
replace the fragment that’s displayed in a fragment. This means 
that we need to make a small change to how we create the 
fragment transaction. 


When we wanted to display a fragment in an activity, we created 
the fragment transaction using the activity’s fragment manager 
like this: 




TVis yts d Yt^CctY\Ct -to 
attivi-tys ma^ajev-. 


FragmentTransaction ft = getFragmentManager ().beginTransaction(); 


The getFragmentManager () method gets the fragment 
manager associated with the fragment’s parent activity. This means 
that the fragment transaction is linked to the activity. 

When you want to display fragments inside another fragment, 
you need to use a slightly different fragment manager. You need 
to use the fragment manager associated with the parent fragment 
instead. This means that any fragment transactions will be linked 
to the parent fragment rather than the activity. 

To get the fragment manager that’s associated with the parent 
fragment, you use the getChildFragmentManager () 

in the transaction looks 

FragmentTransaction ft = getChildFragmentManager ().beginTransaction(); 

So what difference does using getChildFragmentManager () 
make in practice? 


method. This means that the code to beg 
like this: 


This jets a "to ihc 

•(VayweKrt’s 


you are here ► 
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fragment transactions 


getFragmentManagerO creates 
trawsactiows at the activity lavel 

Let’s first look at what would happen if our 

WorkoutDetailFragment used getFragmentManager() to 
create the fragment transaction to display StopwatchFragment. 

When someone clicks on a workout, we want the app to display the 
details of the workout and the stopwatch. MainActivity creates 
a transaction to display WorkoutDetail Fragment. If we use 
getFragmentManager () to display the StopwatchFragment as 
well, we’ll have two transactions on the back stack. 


Display the detail fragment. 


Display the stopwatch fragment. 


Pcware the back button 


^ f 

Ksi% -Po\r bo-th -tva^sad-tio^s 

adds iwo "bransa^tions 仏 ihe badk sta 匕 k. 


The problem with using two transactions to display the workout is that 
weird things happen if the user presses the back button. 

When a user clicks on a workout, and then clicks the back button, they 
will expect the screen to go back to how it looked before. But the back 
button simply undoes the last transaction on the back stack. 

That means if we create two transactions to the workout detail and the 
stopwatch, if the user clicks the back button then all that will happen is 
the stopwatch will be removed. They have to click it again to remove the 
workout detail section. 


13:28 


The Limb Loosener 


Core Agony 
The Wimp Special 


Strength and Length 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 


0 : 00:00 



wm 


The usev tlidks by\ 

•m 七 lie lis 七 jus 七 oy\U b> 
display *tV>c wovkou 七 
derails dir\A s-fcopy/a^h- 


Start 

Stop 

Reset 


The Limb Loosener 


Core Agony 


The Wimp Special 
Strength and Length 


The usev- has -feo ditk 七 he Badk butfco 
-to jc-t badk io wheve 七 hey 
七 ed. Clitkmj 七 he Ba^k bu-t-feo^ 
only v-emoves -the s-topv/aidh. 


來亨 0 13:29 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 
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nested fragments 


Nested fragments need nested transactions 

The problem of having multiple transactions for 
nested fragments was why the child fragment manager 
was created. The transactions created by the child 
fragment manager fit inside the main transactions. So 
when we add the StopwatchFragment to the 
WorkoutDetailFragment using a transaction 
created by getChildFragmentManager (). 
beginTransaction (), the transactions are nested like this: 


Display the detail fragment. 


Display the stopwatch fragment. 


v 一 display *t^c s*tof>wa*U^ means 
^ 一" bo disflay 

is nested ms'idc *tvay\safi.*tioy\ *to 
display detail 


The back stack has one transaction that contains the second 
transaction. When someone presses the back button, the 
display-the-detail-fragment transaction is undone, and that will 
mean that the display-the-stopwatch -fragment transaction is 
undone at the same time. When the user presses the back 
button, the app behaves correctly: 


13:28 


The Limb Loosener 


Core Agony 
The Wimp Special 


Strength and Length 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 


0 : 00:00 



This -time 七 he usc\r has -to pv-css 
"the button \us-t oy\Ct "to 

I I I I ^ 

imdo both 七 he v/ovkou't detail 
s-topv/a-Uh i\ra^sadiioK>s. 


( 亨 0 13:30 


Start 



The Limb Loosener 


Core Agony 


The Wimp Special 
Strength and Length 
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replace fragment 


display the fragment iw its parewfs 
owCreateViewO method 

We want to add StopwatchFragment to the frame layout 
when Workout Detail Fragment’s view gets created. 

When Workout Detail Fragment’s view gets created, its 
onCreateView () method gets called, so we’ll add a fragment 
transaction to the onCreateView () method to display 
StopwatchFragment. Here’s the code: 

QOverride 


Workout 



app/sre/main 



com. hfad. workout 

£j 


WorkoutDetail 

Fragment.java 


public View onCreateView(Layoutlnflater inflater f ViewGroup container. 

Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

workoutld = savedlnstanceState • getLong ( n workoutId n ) ; —* 


广 ^Xdr-c the 


FragmentTransaction ft = getChildFragmentManager().beginTransaction(); 

Add -the StopwatchFragment StopwatchFragment = new StopwatchFragment()’ 

"bra 灼 sa^tio 的 "feo ft • replace (R. id. stopwatch 一 container, StopwatchFragment) ; ^^ Replan "bKc -fva^cv\"t 

ihc bade stadc. 如 ， ,nircj — ， nir / rMi n 1 \ • 1 的七 I Y 


*tvar\sat*tior\. 


.addToBackS tack(null); 
ft. setTransition (Fragmen tTransaction. TRANSIT_FRAGMENT_FADE) ; 、 Set "the 

ft.commit(); 

return inf later . inflate (R. layout. detailcontainer, false); 


"bra 灼 si 七 io 灼 

d 灼 imd'tioh 

siylc- 


As you can see, the code looks almost identical to the code used 
to display a fragment inside an activity. The key difference is 
that we’re displaying a fragment inside another fragment, so 
we need to use getChildFragmentManager () instead of 
getFragmentManager (). 

We’ll show you the full code for WorkoutDetail Fragment 
on the next page, and then see how it runs. 



Dumb Quest! 


9ns 


I can see that the child fragment manager handles the 
case where I put one fragment inside another. But what if I put 
one fragment inside another, inside another, inside another...? 


The transactions will all be nested within each other, leaving 
just a single transaction at the activity level. So the nested set of 
child transactions will be undone by a single Back button click. 
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nested fragments 


The full WorkoutPctailFragmcwt code 

Here’s the full code for WorkoutDetailFragment.java\ 


package com.hfad.workout; 

import android.app.Fragment; 

import android.os.Bundle; 

import android.view.Layoutlnflater; 

import android.view.View; 

import android.view.ViewGroup; 

import android.widget.TextView; 

import android.app.FragmentTransaction; 




WcVc 七 he 

七 ion dlass ， 

J ) 丄 • a •丄 

so v/C V"C 


□ 

Workout 

L Q 

app/sre/main 

- — I 


public class WorkoutDetailFragment extends Fragment 
private long workoutld; 


java 

com. hfad. workout 

WorkoutDetail 

Fragment.java 


Use a 

■tv*a 灼 sa^tio 灼 

"to add 七 he 

"to 

七 he -Pv-arwc 
layout } 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

workoutld = savedlnstanceState • getLong ( ， ’ workoutld ，'）； 


FragmentTransaction ft = getChildFragmentManager().beginTransaction(); 
StopwatchFragment s topwatchFragment = new StopwatchFragment(); 
ft.replace(R.id.stopwatch 一 container, StopwatchFragment); 
ft.addToBackS tack(null); 

ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 
ft.commit(); 

return inflater.inflate(R.layout.fragment workout detail, container, false); 


QOverride 


public void onStart() { 


super.onStart(); 

View view = getView(); 
if (view != null) { 


TextView title = (TextView) view.findViewByld(R.id.textTitle); 
Workout workout = Workout.workouts[(int) workoutld]; 


title.setText(workout.getName()); 

TextView description = (TextView) view•findViewByld(R•id•textDescription); 
description.setText(workout.getDescription()); 


@Override 


TV^CSC methods need *to 


public void onSavelnstanceState(Bundle savedlnstanceState) 


{ 


savedlnstanceState•putLong( n workoutId n , workoutld); 


public void setWorkout(long id) { 
this.workoutld = id; 
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test drive 

K 




Test drive the app 


Now that you’ve added the code to display the stopwatch, let’s 
run the app and check that it works. 

If you select one of the workouts, the workout detail appears 
along with the stopwatch. If you click on the Back button, the 
whole screen goes back to how it looked before: 


( 夸 fl 13:28 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Wimp Special 

5 Pull-ups 
10 Push-ups 
15 Squats 



13:30 


you dlidk oi^ 
d v/ovkou 七 -the 
v/o\rkou-t details a 灼 d 

s-topwaidh appeav. 


0 : 00:00 


Start 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


you t\\cV o\r\ 

Wttowbk *bransa^bcws *to 
add and 

y/ov-kout details a\rc both 
rolled ba 乙 k. TW»s is because 
{\\t *tv-ar\sa^*tior\ *to add 

is v\tsitd m 七 he 
•ansattion *to add 
Y/oV"kou*t details* 


s*bof> 

*brar\ 


Put there's a problem if you try to interact 
with the stopwatch 

If you try to press one of the buttons on the stopwatch, a weird 
thing happens. The app crashes: 



Let’s look at what went wrong. 
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nested fragments 


Why does the app crash if you press a button? 

When we converted the stopwatch activity into a fragment, we 
didn’t change any of the code relating to the buttons. We know 
this code worked great when it was in an activity, so why should it 
cause the app to crash in a fragment? 


Here’s the error output from Android Studio. Gan you see what 
may have caused the problem? 


01-24 17:37:00.326 2400-2400/com.hfad.fraghack E/AndroidRuntime : FATAL EXCEPTION: main 

Process : com.hfad.fraghack, PID: 2400 

java.lang • 工 llegalStateException: Could not find a method onClickStart(View) in the activity 
class com.hfad.fraghack.MainActivity for onClick handler on view class android.widget. 
Button with id 'start_button' 

at android.view.View$1.onClick(View.java:3994) 
at android.view.View.performClick(View.java : 4756) 
at android.view.View$PerformClick.run(View.java:19749) 
at android.os.Handler.handleCallback(Handler.java:739) 
at android.os.Handler.dispatchMessage(Handler.java:95) 
at android.os.Looper.loop(Looper.java:135) 

at android.app.ActivityThread.main(ActivityThread.j ava : 5221) 
at java.lang.reflect.Method.invoke(Native Method) 
at java.lang.reflect.Method.invoke(Method.java : 372) 

at com.android.internal.os.ZygoteInit$MethodAndArgsCaller•run(Zygotelnit•java:899) 
at com.android.internal.os.Zygotelnit.main(Zygotelnit.j ava : 694) 

Caused by: j ava.lang.NoSuchMethodException : onClickStart [class android.view.View] 
at j ava.lang.Class.getMethod(Class.j ava : 664) 
at java.lang.Class.getMethod(Class.java:643) 
at android.view.View$1.onClick(View.java:3987) 
at android.view.View.performClick(View.java : 4756) 
at android.view.View$PerformClick.run(View.java:19749) 
at android.os.Handler.handleCallback(Handler.java:739) 
at android.os.Handler.dispatchMessage(Handler.java:95) 
at android.os.Looper.loop(Looper.java:135) 

at android.app.ActivityThread.main(ActivityThread.j ava : 5221) 
at java.lang.reflect.Method.invoke(Native Method) 
at java.lang.reflect.Method.invoke(Method.java : 372) 

at com.android.internal.os.ZygoteInit$MethodAndArgsCaller•run(Zygotelnit•java:899) 
at com.android.internal.os.Zygotelnit.main(Zygotelnit.j ava : 694) 




y»kcs. 


you are here ► 


345 




on Click revisited 


Lcfs look at the StopwatchFragmcwt layout code 


In the layout code for the StopwatchFragment, we’re binding 
the buttons to methods in the same way that we did for an activity, by 
using the android : onClick attribute to say which method should 
be called when each button is clicked: 

<?xml version="1.0" encoding= M utf-8"?> 


WicVe *tV^c same Isyout -fov 

as wc did vt was a 於 


<RelativeLayout xmlns : android="http :// schemas.android.com/apk/res/android' 


<Button 

android : id= M @ + id/start_button" 
android : layout_width= n wrap_content" 
android : layout—height= n wrap—content” 
android : layout_below="@+id/time_view" 
android : layout_centerHorizontal= M true 
android : layout_marginTop="20dp n 
android:onClick= n onClickStart" 
android : text="@string/start" / > 

<Button 

android : id="@+id/stop_button" 
android : layout_width= n wrap_content' 
android : layout—height= n wrap—content' 
android : layout_below="@+id/start—button’ 
android : layout_centerHorizontal= M true 
android : layout_marginTop="10dp" 

android:onClick= n onClickStop" _ 

android:text="@string/stop" / > 


<Button 

android : id="@+id/reset_button" 
android : layout_width= n wrap_content" 
android : layout_height= M wrap_content" 
android : layout_below="@+id/stop_button' 
android : layout_centerHorizontal="true" 
android : layout_marginTop= M 10dp' 
android:onClick= M onClickReset M 
android : text="@string/reset" / > 
</RelativeLayout> 


□ 

Workout 

L u 

app/sre/main 


res 


^jj 

ayout 

■ <%ml>| 

</ 

fragment— 
stop watch, xml 




usrnj -the a^d\roid ： OK>Clitk 
aii\ribuics m -the layoui -to say 
whidh mcihods should be called 
when cadh birtton is dlidked- 


So why should we have a problem now that we’re using a fragment? 
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nested fragments 


The onClick attribute calls methods 
m the activity, wot the fragment 

There’s a big problem with using the android : onClick 
attribute to say which method should be called when a view is 
clicked. The attribute specifies which method should be called 
in the current activity. This is fine when the views are in an 
activity’s layout. When the views are in a fragment this leads to 
problems. Instead of calling methods in the fragment, Android 
calls methods in the parent activity. If it can’t find the methods in 
this activity, the app crashes. 


The problem occurs regardless of whether the fragment is 
included in an activity, or nested inside another fragment. It 
applies to all fragments. 


It’s not just buttons that have this problem. The 
android : onClick attribute can be used with any views that 
are subclasses of the Button class. This includes checkboxes, 
radio buttons, switches, and toggle buttons. 



Activity 


Now we could move the methods out of the fragment into the 
activity, but that approach has a major disadvantage. It would 
mean that the fragment is no longer self-contained — if we 
wanted to reuse the fragment in another activity, we’d need to 
include the code in that activity too. Instead, we’ll deal with it in 
the fragment. 

Howto make button clicks call methods w the fragment 


There are two things you need to do in order to get buttons in a 
fragment to call methods in the fragment instead of the activity: 


o 

❺ 


Remove references to android：onClick in the fragment layout. 

Buttons attempt to call methods in the activity when the android : onClick 
attribute is used, so these need to be removed from the fragment layout. 

Bind the buttons to methods in the fragment by implementing an 
onClickListener. 

This will ensure that the right methods are called when the buttons are clicked. 


Let’s do this now in our Stopwatch Fragment. 
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remove on Click 


First remove the owClick attributes 
from the fragment's layout 

The first thing we’ll do is remove the android : onClick lines 
of code from the fragment’s layout. This will stop Android trying 
to call methods in the activity when the buttons are clicked: 

<?xml version^"1.0" encoding="utf-8"?> 

<RelativeLayout xmlns : android= M http :// schemas.android.com/apk/res/android' 


<Button 

android : id="@+id/start—button" 
android : layout_width="wrap_content n 
android : layout—height= n wrap_content，' 
android : layout_below="@+id/time_view" 
android : layout_centerHorizontal= M true 
android : layout_marginTop= M 20dp M 

android : text="@string/start" / > 

<Button 

android:id= M @+id/stop button" 
android:layout_width= n wrap_content , 
android : layout—height= n wrap_content’ 
android : layout_below="@+id/start_button' 
android : layout_centerHorizontal= M true" 
android : layout marginTop="10dp" 


android:text= M @string/stop" / > 

<Button 

android : id="@+id/reset button" 
android:layout_width= n wrap_content n 
android : layout 一 height= n wrap_content’ 
android : layout_below="@+id/stop_button' 
android : layout_centerHorizontal="true 
android : layout_marginTop= M 10dp' 

android : text="@string/reset" / > 
</RelativeLayout> 


□ 


Workout 


L Q 

app/sre/main 


res 


□ 

layout 




fragment— 
stopwatch.xml 


Remove oy\CI»^k 
a*t*tv-*»bu*tcs -fov- tacM 
of i\\t butbems •… 


The next thing is to get the fragment to respond to button clicks. 
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nested fragments 


Make the fragment implement OnClickListener 


To make the buttons call methods in StopwatchFragment when they are clicked, 
we’ll make the fragment implement the View. OnClickListener interface like 
this: 


TV^is ⑼七 

•m*to 扣 




public class StopwatchFragment extends Fragment implements View.OnClickListener { 


This turns StopwatchFragment into a type of View. OnClickListener so 
that it can respond to when views are clicked. 

You tell the fragment how to respond to clicks by implementing the 

View. OnClickListener onClick () method. This method gets called 

whenever a view in the fragment is clicked. 

@Override 

public void onClick(View v) { ^T ^ ou ⑽ s 七 ovc\r\ridc -the OhCkkO 

method ih you\T -P\ragmch-t dodc. 

} 

The onClick () method has a single View parameter. This is the view 
that the user clicks on. You can use the View getld () method to find 
out which view the user clicked on, and then decide how to react. 


Code Magnets 

See if you can complete the 
StopwatchFragment onClick () 
method. You need to call the 
onClickStart () method when the Start 
button is clicked, the onClickStop () 
method when the Stop button is clicked, and 
the onClickReset () method when the 
Reset button is clicked. 




QOverride 

public void onClick(View v) { 

switch ( . ) 

case R.id.start—button: 

onClickStart( 
break; 

case R.id.stop_button : 


break; 

case R.id.reset—button: 
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magnets solution 



Code Magnets Solution 

See if you can complete the 
StopwatchFragment onClick () 
method. You need to call the 
onClickStart () method when the Start 
button is clicked, the onClickStop () 
method when the Stop button is clicked, and 
the onClickReset () method when the 
Reset button is clicked. 





厂 true I 


>u didn't *to 
use *t^csc 


QOverride 

public void onClick(View v) { 


switch 


( v I . getld()」）{ 


case R.id.start—button: 


onClickStart( v | ) 

break; 

case R.id.stop—button: 

I onClickStop | ( 「 

break; 

case R.id.reset—button: 

I onClickReset~~v 


The StopwatchFragment owClickO method 


Here’s the code to implement the StopwatchFragment 
onClick () method so that the correct method gets called when 
each button is clicked: 


@Override ^ ^ This is i\\t View *tKc usc\r dlidkcd oy\. 

public void onClick(View v) { 

switch (v.getldO) { - Chcdk v/hidh \/icv/ was didked. 


case R.id.start— button: 
onClickStart (v) ; 
break; 

case R.id.stop_button : 
onClickStop(v); 
break; 

case R.id.reset—button: 
onClickReset(v); 
break; 


|,f butbm was ditked ， 

tall ohCkkSta^rK) wthod. 

I*f 七 he S-top bu*tto 灼 was c\\tktd, 
△all "the o^ClidkS-fcopO method- 

|-f Rcsc*t bu*t*toy> >was dlidkcd, 
dall oy>CI*itkRcsc*tO method. 


There’s just one more thing we need to do: we need to attach the 
listener to the buttons in the fragment. 


350 Chapter 8 




































nested fragments 


Attach the OwClickListewcr to the buttons 


To make the views respond to clicks, you need to call 
each view’s setOnClickListener () method. 

The setOnClickListener () method takes 
an OnClickListener object as a parameter. As 
StopwatchFragment implements the OnClickListener 
interface, we can use this to pass the fragment as the 
OnClickListener. 


As an example, here’s how you attach the OnClickListener to 
the Start button: 


3 *to 


Button startButton = (Button) layout.findViewByld(R.id.start_button); 
startButton.setOnClickListener(this); 


Attach the lislchcv- b> the buWoh. 


The call to each view’s setOnClickListener () method 
needs to be made after the fragment’s views have been created. 
This means they need to go in the StopwatchFragment 
onCreateView () method like this: 


©Override 


public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inflater.inflate(R.layout.stopwatch, container, false); 
runTimer(layout); 


Button startButton = (Button)layout.findViewByld(R.id.start_button); 
startButton.setOnClickListener(this); 

Button stopButton = (Button)layout•findViewByld(R.id.stop 一 button); 
stopButton.setOnClickListener(this); 

Button resetButton = (Button)layout.findViewByld(R.id.reset_button); 
resetButton.setOnClickListener(this); 

个 

Workout 


return layout; 



This at-bdhes -the listchC\r -to -the buttohS. 


We’ll show you the full StopwatchFragment code on the next 
page. 


L d 

app/sre/main 

Z3 


java 




com. hfad. workout 

■ tint F*«{l 

Stopwatch 

Fragment.java 
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StopwatchFragment code 


The StopwatchFragmcwt code 


Here’s the revised code for StopwatchFragment.java : 


package com.hfad.workout; 

1/VcVc us*»^ ButW tlass, so y/c II it 




import android.widget.Button; 


The J^ccds -to irwplcmc^i 

the \/ic>w.O^CIi^kListchC\r 


public class StopwatchFragment extends Fragment implements View.OnClickListener 
/ /Number of seconds displayed on the stopwatch. 
private int seconds = 0; 


m 


//Is the stopwatch running? 
private boolean running; 
private boolean wasRunning; 


Workout 


^ v*c y\oi the ov\CrcaicO method. 

/ 


@Override 

public void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
if (savedlnstanceState != null) { 

seconds 二 savedlnstanceState • getlnt (’’seconds▼'); 
running = savedlnstanceState.getBoolean("running"); 
wasRunning = savedlnstanceState•getBoolean( n wasRunning n ) 
if (wasRunning) { 


L Q 

app/sre/main 
java 


4 H 1 


com. hfad. workout 

«latt F*«(| 

Stopwatch 
Frag merit.java 


running 


true; 


} Update i\\t cmOcateVicwO mc*t^od *to 

a-tta^ listener -to buttms- 

@Override ^ 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 


View layout = inflater.inflate(R.layout.stopwatch, container, false); 
runTimer(layout); 

Button startButton = (Button) layout•findViewByld(R.id.start— button); 
startButton.setOnClickListener(this); 

Button stopButton = (Button) layout•findViewByld(R.id.stop 一 button); 
stopButton.setOnClickListener(this); 

Button resetButton = (Button) layout.findViewByld(R.id.reset_button); 
resetButton.setOnClickListener(this); 

return layout; 
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nested fragments 


The StopwatchFragmcwt code (continued) 


@Override 

public void onClick(View v) { 
switch (v.getld()) { 

case R.id.start—button: 
onClickStart(v); 
break; 

case R.id.stop_button : < 
onClickStop(v); 
break; 

case R.id.reset—button: 
onClickReset(v); 
break; 



/\s y/cVc 

wc v\tcd *to 
ovevvide or\ClidkO 

Call ihc appv-opv-ia-tc mc-thod 

m "the -fov* -the 

button 七 ha 七 v/as disked. 

□ 

Workout 

L C3 

app/sre/main 

-TH 

java 


public void onClickStart(View view) 
running = true; 

} 


public void onClickStop(View view) { 
running = false; 


com. hfad. workout 

■ t\**t f-il 

f“i ‘‘ …垂 

o 

Stopwatch 

Fragment.java 


Tiicsc av-c same 

■ methods wc 

V^adi bc-fov-c. TV^cyll 
yt ddlled -bV^c 
bu*t*to^s av"c tlitkcd- 


public void onClickReset(View view) 
running = false; 
seconds = 0; 

} 


Let’s see what happens when we run the app. 
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test drive 

Test drive the app 

Now when you run the app, the buttons on the stopwatch work correctly. 



Put there's a problem when you rotate the device 


If you start the stopwatch and then rotate the device, something strange 
happens. The stopwatch is reset to 0: 


氽穿 Q 13:23 


The Limb Loosener 
Core Agony 
The Wimp Special 
Strength and Length 


The Wimp Special 


5 Pull-ups 
10 Push-ups 
15 Squats 


0 : 00:08 



13:21 


S*tav 七七 he a 灼 d 

vo*ta*tc dcvidc- 


We’ve seen before that changing the screen orientation can reset the views. 
So what happens to fragments when you change the orientation? 
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Rotating the device re-creates the activity 

As you already know，when you’re running an app and 
rotate the device, the activity that’s running gets destroyed 
and re-created. All variables in the activity code are set 
back to their default values; if you want to save these values 
before the activity’s destroyed, you need to use the activity’s 
onSavelnstanceState () method. 

But what if the activity contains a fragment? You’ve already 
seen that the activity and fragment lifecycles are closely related, 
but what happens to the fragment when you rotate the device? 


What happens to the fragment whew you rotate the device 



An activity contains a fragment. 



Activity 



Fragment 



When the user rotates the device, the activity is 
destroyed along with the fragment. 



what happens 


The story continues... 



The activity is re-created and its onCreate() method is 
called. 

The onCreate () method includes a call to setContentView (). 


o 。一。 

Activity 


❹ When the activity s setContentView() method runs, it 
reads the activity's layout and replays its fragment 
transactions. 

The fragment is re-created in line with its latest transaction. 



Fragment 



Fragment 


When you rotate the device, the fragment should go back to the 
same state it was in before the device was rotated. So why, in 
our case, has the stopwatch been reset? To get some clues, let’s 
look at the WorkoutDetailFragment onCreateView () 
method. 
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nested fragments 


owCreateVicwO ruws AFTER the 
transactions have been replayed 


The onCreateView () method runs after the activity has replay 
all of the activity’s fragment transactions. Here’s the method. Gan 
you see why the stopwatch gets reset to 0 seconds when the device is 
rotated? 


@Override 


v/() mC*thod m ^uir>s 

adtiv*i*ty Kas veflayed all o-f its *tvair>sadtioy>s. 


public View onCreateView(Layoutlnflater inflater, ViewGroup container. 


Bundle savedlnstanceState) 
if (savedlnstanceState != null) { 

workoutld = 


{ This \rur>s i-f 

l/Vb\rkou-tDctailF\ragrwc^i 

savedlnstanceState . getLong ( "workoutld" ) ; s ^ v ^d i*ts pv-iov 

"to bemj destroyed- 


This 

vcfladcs *thc 

s*fcopy/a*tdh 

七 

Wi 七 a 
bv*ar>d-ir>C>M 


O 灼 C. 


’FragmentTransaction ft = getChildFragmentManager().beginTransaction(); 

S topwatchFragment stopwatchFragment = new StopwatchFragment(); 
ft.replace(R.id.stopwatch 一 container, stopwatchFragment); 
ft.addToBackS tack(null); 

ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 
ft.commit(); 

return inflater.inflate(R.layout.fragment workout detail, container, false); 


□ 


Workout 


The onCreateView () method includes a fragment transaction that 
replaces the stopwatch fragment with a brand-new one. This means 
that two things happen: 

o The activity replays its fragments transactions, putting the stopwatch 
fragment in the state it was in before the device was rotated. 

❺ The onCreateView () method gets rid of the stopwatch fragment 
the activity reinstated, and replaces it with a brand-new one. As it’s a 
new version of the fragment, the stopwatch is reset to 0. 


L Q 

app/sre/main 

~Z 3 


java 


com. hfad. workout 

■ <>«*« F*«{| 

f“li■ 

WorkoutDetail 

Fragment.java 


To stop this from happening, we need to make sure we only replace 
the fragment if the savedlnstanceState Bundle is null. This 
will mean that a brand-new StopwatchFragment is only displayed 
when the activity is first created. 
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WorkoutDetailFragment code 


The WorkoutPetailFragmcwt code 

Here’s the full code for WorkoutDetailFragment.java : 
package com.hfad.workout; 


public class WorkoutDetailFragment extends Fragment { 
private long workoutld; 

@Override 

public View onCreateView(Layoutlnflater inflater f 


□ 

Workout 

L r~i 

v > J 

app/sre/main 



com. hfad. workout 



WorkoutDetail 

Fragment.java 

ViewGroup container. 


The or\Vf 
Y\ttd *to make is -fco / 
f u*t *tvar>sad*t*ior> / 

\y\ ay\ else 
The *tv-ay>sadtior> 

Will or>ly vu 灼 i*f 

saved Ir>s*tair>dcS*ta*tc 
is y>ull- 


Bundle savedlnstanceState) { 
if (savedlnstanceState != null) { 

workoutld = savedlnstanceState • getLong ( "workoutld ，，）； 

} else { 

FragmentTransaction ft = getChildFragmentManager().beginTransaction() 
StopwatchFragment stopwatchFragment = new StopwatchFragment(); 
ft•replace(R•id•stopwatch—container, stopwatchFragment); 
ft.addToBackStack(null); 

ft.setTransition(FragmentTransaction.TRANSIT—FRAGMENT—FADE); 
ft.commit(); 



return inflater.inflate(R.layout.fragment workout detail, container, false) 


@Override 

public void onStart() { 

super.onStart(); 

View view = getView(); 
if (view != null) { 

TextView title = (TextView) view.findViewByld(R.id.textTitle); 
Workout workout = Workout.workouts[(int) workoutld]; 


title.setText(workout.getName()); 

TextView description = (TextView) view•findViewByld(R•id•textDescription); 
description.setText(workout.getDescription()); 


QOverride 

public void onSavelnstanceState(Bundle savedlnstanceState) { 
savedlnstanceState • putLong (’’workoutld’ ，， workoutld); 

} 

public void setWorkout(long id) { 
this.workoutld = id; 


Let’s see what happens when we run the code. 
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nested fragments 


K 




Test drive the app 


Run the app, start the stopwatch, then rotate the device. Let’s 
see what happens to the stopwatch. 



The stopwatch keeps going. Even though rotating the 
device means that the activity is destroyed, the fragment 
transactions replay successfully. We’re no longer replacing 
StopwatchFragment with a brand-new fragment. 


tJiereictre no 

Dumb Qu 


esti9ns 


If I use the android : onClick attribute in my 
fragment layout code, will Android really try to call a method in 
my activity? 

Yes, it will. Rather than use the android: onClick 
attribute to get views to respond to clicks, implement an 

OnClickListener instead. 

Does this apply to nested fragments, or fragments in 
general? 

It's common behavior with all fragments, irrespective of 
whether they’re nested inside another fragment. 


Should I use fragments in my own apps? 

That depends on your app and what you want to achieve. 

One of the major benefits of using fragments is that you can use 
them to support a wide range of different screen sizes. You can, say, 
choose to display fragments side by side on tablets and on separate 
screens on smaller devices. You’ll also see some more ways in 
which using fragments can be useful in the next couple of chapters... 
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exercise 




BE th^ 

Below are two pieces of fragment layout 
code, and on the next pa^e Biere are two 
pieces of fragment Java code. Your job 
I 丄 is to play like you’re Ae 

fragment and say 


combixiation will display a 
message ^ien the switch in 
the layout is on. 



〈LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width="match_parent" 
android : layout—height= n match—parent▼' 
android : orientation= M vertical" 


tools : context= M com.hfad.chlOex.SwitchFragment M > 



<Switch 

android : id="@+id/switch—view" 


android : layout_width= M wrap_content" 
android : layout_height="wrap_content" / > 
</LinearLayout> 


TV^csc av-c 

-fv"a^w\Ch*t layout to&t- 

<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= n match—parent，' 
android : layout—height= n match—parent，' 
android : orientation= M vertical" 



tools : context= M com.hfad.chlOex.SwitchFragment"> 


<Switch 

android : id=" @+id/switch—view ’， 
android : layout_width= M wrap_content" 
android : layout_height="wrap_content" 
android:onClick="onClick" / > 

</LinearLayout> 
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nested fragments 



public class SwitchFragment extends Fragment implements View.OnClickListener{ 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

return inf later . inflate (R. layout. f r agment_s witchcontainer, false); 



@Override 

public void onClick(View v) { 

if (v.getld() == R.id.switch 一 view) { 
if (((Switch) v).isChecked()) { 

Toast•makeText(v•getContext(), "On", Toast•LENGTH—SHORT).show(); 

} 

} 

} 

} ' 

These av*c "the "tv/o pieces o( 

■f\raairwcr>"t Jdvd Code 

public class SwitchFragment extends Fragment implements View.OnClickListener{ 


QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inflate (R. layout. f ragment_switch,- container, false); 
Switch switchView = (Switch) layout•findViewByld(R•id•switch 一 view); 
switchView.setOnClickListener(this); 
return layout; 


@Override 

public void onClick(View v) { 

if (v.getld() == R•id•switch—view) { 
if (((Switch) v).isChecked()) { 

Toast•makeText(v•getContext(), "On", Toast•LENGTH—SHORT).show(); 
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solution 



BE{h^ §©lug©ti 

Below are two pieces of fragment layout 
code, and on the next pa^e Biere are two 
pieces of fragment Java code. Your job 

is to play like you’re Ae 
fragment and say 
conrbixiation will display a 
message Wien the switch in 
® the layout is on. 



〈LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout_width="match_parent" 
android : layout—height= n match—parent▼' 
android : orientation= M vertical" 



tools : context= M com.hfad.chlOex.SwitchFragment M > 


<Switch 

android : id="@+id/switch—view" 


This is toYYtt^ layout toAt- 


android : layout_width= M wrap_content" 
android : layout_height="wrap_content" / > 
</LinearLayout> 



<LinearLayout xmlns : android="http :// schemas.android.com/apk/res/android" 
xmlns : tools="http :// schemas.android.com/tools" 
android : layout—width= n match—parent，' 
android : layout—height= n match—parent，' 
android : orientation= M vertical" 


tools : context= M com.hfad.chlOex.SwitchFragment"> 



<Switch 

android : id= ，， @+id/switch—view" 
android : layout_width="wrap_content n 
android : layout 一 height= n wrap_content n 
android:onClick="onClick" / > 


</LinearLayout> 


The Swi*t^h m -this layout Code uses 
ar\d\roid ： ohClidk a*bbribu*te. This y/ill td\\ 

Code \y\ -the ad*tivi*ty> 的 o*t *thc 
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public class SwitchFragment extends Fragment implements View.OnClickListener{ 



@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

return inflater.inflate(R.layout.fragment switch, container, false); 


@Override 

public void onClick(View v) { 

if (v.getld() == R.id.switch 一 view) { 
if (((Switch) v).isChecked()) { 

Toast.makeText(v.getContext() 

} 


This Codt iinr\plcmCh*ts V\t^ OY\C\\CMU\s{,tY\Cr, 
bu 七 doesn't sc*t lis*tcr\CV *to -the Sy/i*tdlv 

The ohCli^kO method yb called- 

'On，，，Toast .LENGTH SHORT) . show (); 



public class SwitchFragment extends Fragment implements View.OnClickListener{ 



QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

View layout = inf later . inflate (R. layout. f ragment_switch,- container, false); 
Switch switchView = (Switch) layout•findViewByld(R•id•switch 一 view); 
switchView.setOnClickListener(this); 
return layout; 


@Override 

public void onClick(View v) { 

if (v.getld() == R•id•switch—view) { 
if (((Switch) v).isChecked()) { 

Toast.makeText(v.getContext() 


This is Java Code l/Vhch *thc 

Swi*t^h is didked, ohClidkO nr\C*thod \ruhS 

0n n , Toast.LENGTH SHORT).show(); 
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Your Android Toolbox 

You’ve got Chapter 8 under 
your belt and now you’ve 
added nested fragments to your 
toolbox. 


You c^y\ download 
-full code ^OV 

Wt 七尸 : //Uy^avU^/ 

HcadPtv-stA^dvoid. 



BULLET POINTS 


■ 


■ 


■ 


Fragments can contain other fragments. 

If you’re nesting a fragment in another fragment, you need to add the 
nested fragment programmatically in Java code. 

When you perform transactions on a nested fragment, use 

getChildFragmentManager () to create the transaction. 

■ If you use the android ： onClick attribute in a fragment, Android 
will look for a method of that name in the fragment’s parent activity. 

■ Instead of using the android ： onClick attribute in a fragment, 
make the fragment implement the view. OnClickListener 
interface and implement its onClick () method. 


■ 


When the device configuration changes, the activity and its 
fragments get destroyed. When the activity is re-created, it replays 
its fragment transactions in the onCreate () method’s call to 

setContentView(). 

■ The fragment’s onCreateView () method runs after the activity 
has replayed its fragment transactions. 


oo 臣 HJyJP 


364 


Chapter 8 













9 action bcirs 


^ Taking Shortcuts ♦ 



Wed have got 
here hours ago if shed 
known about the Up 
button. Harrumph! 


Everybody likes a shortcut. 

And in this chapter you’ll see how to add shortcuts to your apps using action bars. We’ll 
show you how to start other activities by adding action items to your action bar, how to 
share content with other apps using the share action provider, and how to navigate up 
your app’s hierarchy by implementing the action bar’s Up button. Along the way, you’ll see 
how to give your app a consistent look and feel using themes, and introduce you to the 
Android support library package. 


this is a new chapter 









app structure 


ftreat apps have a clear structure 

Back in Chapter 6, we looked at ways of structuring an app to 
create the best user experience. Remember that when you create 
an app, you will have three different types of screen: 



They also have great shortcuts 

If a user’s going to use your app a lot, they’ll want quick ways to 
get around. We’re going to look at navigational views that will give 
your user shortcuts around your app, providing more space in your 
app for actual content. Let’s begin by taking a closer look at the 
top-level screen in the above Pizza app. 
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action bars 


Piffcrewt types of wavigatiow 

In the top-level screen of the Pizza app, there’s a list of options for 
places in the app the user can go to. 


TW\s is P*» 2 ^a app - level 


T~Kcsc |ihk sd\TCChS. 


TW 丨 s -takes you -to a detail/ td\i scrttv\ 
you ertait a ^ order. 


eits and pL^ols 


Pizzas 


Pasta ^ 


Stores 



Create Order 亡 


The first three options link to category activities; the first presents 
the user with a list of pizzas, the second a list of pasta, and the third 
displays a list of stores. You can think of the category activities as being 
passive. They display information and help you get around. 


The fourth option links to a detail/edit activity that allows the user 
to create an order. This option is active. It allows the user to create 
something. 


You generally deal with active and passive navigation options in 
different ways. In this chapter, we’re going to look at how you deal with 
active navigation options. 

Using actions for navigation 

In Android apps, active navigational options are usually added to 
the action bar. The action bar is the bar you often see at the top 
of activities. It’s the place where common actions are displayed, 
so it normally includes buttons that are best described using verbs 
such as Create, Search, or Edit. 

In the Pizza app, we can make it easy for the user to place an 
order wherever they are in the app by adding an action bar to the 
top of every activity. The action bar will include a Create Order 
button so the user has access to it wherever they are. 

Let’s take a closer look at how you add action bars to your apps. 


TWis is achoY\ bav-. 



This is -the Cv-catc 0\rdcv- but-fcoh. 
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action bars and themes 


Lcfs start with the action bar 


The action bar has a number of uses: 


o 

o 

o 


For displaying the app or activity name so that the user knows where in 
the app they are. As an example, an email app might use it to indicate 
whether the user is in her inbox or junk folder. 

For making key actions prominent in a way that’s predictable — for 
example, sharing content or performing searches. 

For navigating to other activities to perform an action. 


To add an action bar, you need to use a theme that includes an action 
bar. A theme is a style that’s applied to an entire activity or application so 
that your app has a consistent look and feel. It controls such things as the 
color of the activity background and action bar, and the style of the text. 
Android has a number of built-in themes you can use. 

API level 11 and above 

If you want your apps to run on API level 11 or above, you add an action 
bar by applying Theme . Holo or one of its subclasses. This is what you’ll 
need to do most of the time. For API level 21 or above, you have the added 
option of using one of the newer Theme . Material themes. There are 
several different themes to choose from depending on what appearance 
you want your app to have. As an example, applying a theme of Theme . 
Material. Light. DarkActionBar will give you activities with a 
light background and a dark action bar. 




"TKci^c. — ' 
Material. 
Light. 



API level 7 or above These av-C examples o-f 七 v/o di*WW ⑶七 -themes. 


Tiicmc. 

ttolo. 

L’ 吵七. 


If you need to support older devices running API level 7 or above, you 


can still add an action bar but you need to do it slightly differently. You 
first need to change your activities so that they extend the class android 
support. v7 . app . ActionBarActivity instead of the android. 
app . Activity class. You must then apply one of the Theme . 

App Comp at themes. 


之一 You ov\\y -fco -take 七 his 

i*f you miend "to support oldcv- devils 
API levels 1, G, % ov lO. Most 
devils \rujr> a hi—\r API level 七 han 七 his. 


The ActionBarActivity class and the Theme . AppCompat themes 
are included in the Android support libraries. Let’s look at these in 
more detail. 
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action bars 


The Android support libraries 

As time passes, Android continued to add new features. But what if you 
want to use the latest Android widgets on a device that’s two or three 
years old? The Android support libraries are a set of code libraries that 
you can include in your project. They’re primarily there for backward 
compatibility, as they allow you to use newer features of Android in older 
devices. 


Some features of Android are only available in the support libraries, so 
if you need to use these features in your app, you need to use the support 
library. As an example, the Drawer Layout APIs allow you to create a 
navigation drawer you can pull out from the side of the screen, and these 
APIs are currently only available in the v4 support library. 

The Android support library package includes several support libraries. 
Each one targets a base API level and includes a specific set of features. 
The name of the support library reflects the lowest version number 
of Android the library is compatible with. The v4 support library, for 
instance, can be used with API level 4 and higher. Similarly, the v7 support 
libraries can be used with API level 7 and higher. Each of these libraries 
undergo revisions to include new features and bug fixes. 


The classes in a support library are stored within packages named 
android. support • v*. As an example, the v4 library has classes in 
the android. support. v4 package. 


Here are some of the libraries in the Android support library package: 


v4 support library 

Includes the largest set of features, such 
as support for application components 
and user interface features. 


v7 appeompat library 

Includes support for action bars on 
API level 7 and above, also creating 
and using material design. 



v7 cardview library 

Adds support for the CardView ^ . , C 

wiHapf allnwinaA/nn tn Anw just SOW 

七 he su\>\>ov-*b libv-av-ics. 


widget, allowing you to show 
information inside cards. 


v7 gridlayout library 

Adds support for the 
GridLayout class. 


v7 recyclerview library 

Adds support for the 
RecyclerView widget. 


vl7 leanback library 

Includes APIs allowing you to 
build user interfaces for TVs. 


Android Studio will often add support libraries to your project by default. 
To see this, let’s create a new project to prototype the Pizza app and see if 
there are any references to them. 
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Your project may include support libraries 

We’re going to build a prototype of the Pizza app that supports API level 
17 and above. Create a new Android project with a blank activity for an 
application named “Bits and Pizzas” with a package name of 
com.hfad.bitsandpizzcis. The minimum SDK should be API level 17. Specify 
an activity called u MainActivity 5, , a layout called “activity_main” and a 
menu resource called “menu—main’’. 

We’re going to look at how your new project may be using support libraries 
by default. First, let’s look at MainActivity.java . Here’s the code that Android 
Studio created for us. By default, MainActivity extends the android. 
support. v7 . app . ActionBarActivity class. In other words, it’s 
using a v7 support library: 

package com.hfad.bitsandpizzas; 

import android.support.v7.app.ActionBarActivity; 


TKc a^d\ro*idi.suffov-t.vT *m i\\t 

^ -tells you 

K \Vs Ml 狄 y. 


public class MainActivity extends ActionBarActivity { 

... ^ y 

、 yW /WaihAd-tivi-ty.java toAt may 

} look di-PWht H depends oh ihe 

behavior of ihc IDB youVc us”. 


The ActionBarActivity class is used in conjunction with the Theme . 
App Comp at themes to add action bars to apps that support API levels 
between 7 and 10. If you use the ActionBarActivity class as the 
superclass for your activities, you have to use one of these themes or your 
app won’t run. You can’t use more recent themes, such as Material. 

Even if you remove references to ActionBarActivity from your app, 
the v7 support library may still be a dependency in your project. You can 
see this by going to File—Project Structure. When you click on the app 
module and choose Dependencies, you may find there’s a reference to the 
v7 appeompat library: 


/ \y>d\ro'id Studio au*tomatitally added 
v "7 libv-avy as a 

dcpc^dc^ty- oy\ >n\\\cM 

vcv-s'ioir> of f[Y\Ayo\d S*tudio you v*c 
us'nr>^ ; you m 3 y ov* y>o*t 七 iVis. 


o 


Project Structyre 


Properties 

Signing 

Flavors 

Buijd Types 

D€pend«imci€B 

_ d 


SDK Location 
Project 

— Modules 一 


app 



/ Scope 

(d^llbs, indyde=[*.iafl} ^ 

， Compile 



com.an£Jroid.support:appcompat-v7:Z 


LO.T^) 


Compile 


▼ 
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Well get the app to use up to date themes 


We want our prototype app to include action bars. The app supports 
devices running a minimum of API level 17, so we don’t need to 
provide backward compatibility by using Act ionBarActivity 
and Theme . AppCompat. Instead, we’ll bring the look more up 
to date by using a Holo theme by default, and get it to switch to a 
Material theme if it’s running on API level 21. 


To do this, we need to do two things: 



Make sure the activity code doesn’t reference Act ionBar Activity. 

If it does, we’ll only be able to use a Theme . AppCompat theme. 



Apply the themes. 

We’ll get the app to pick up the right theme for the API level it’s running on. 


We’re going to keep the dependency on the v7 appeompat library as 
this has an impact on the code you’ll write later on. 

Change MainActivity to use aw Activity 

We’ll start by making sure that MainActivity.java uses the Activity 
class and not Act ionBar Activity. Update your code so that it 
looks like the code below: 


package com.hfad.bitsandpizzas; 

import android.app.Activity; 
import android.os.Bundle; 

public class MainActivity extends 


Make sure your attwity 知七士 七七 

you use 

you use ttolo or Material themes, 

\orCts you -to use 

^ □ 

BitsAndPizzas 


Activity { 


@Override 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_main); 


Now that we know MainActivity doesn’t use 

Act ionBar Activity, we’ll look at how you apply a theme. 


L Q 

app/sre/main 

L Q 



com.hfad.bitsandpizzas 

I \t\»u f>T{| 

a 

MainActivity.java 
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Apply a theme in AndroidManifest.xml 

As you’ve already seen, the app ? s AndroidManifest.xml file provides essential 
information about the app such as what activities it contains. It also includes a 
number of attributes that have an impact on your action bars. 

Here’s the AndroidManifest.xml code Android Studio created for us (weVe 
highlighted the key areas): 


门 

BitsAndPizzas 

L a 

app/src/main 


AndroidManifest.xml 



〈manifest xmlns : android="http : // schemas . android. com/apk/res/android' 


package="com.hfad.bitsandpizzas" > 
〈application 

android:allowBackup="true" 

android:icon= n @mipmap/ic—launcher' 
android : label= n @ s tring/app—name ’▼ 
android : theme: n @style/AppTheme，▼ > 

〈activity 


The s S*tud»o 

- pv-ov*idcs oy\c by default 

Uscv*--fvic^dly of 七 he app 

The 


android:name= M .MainActivity" 

android: label= n @string/app—name'▼ 


> 


Uscv*—-fv-'ic^dly o( ad*tWi*ty 


</activity 〉 
</application 〉 
〈 /manifest 〉 


The label 

The id 。 灼 



The android : icon attribute is used to assign an icon to the app. The icon is 
used as the launcher icon for the app, and if the theme you’re using displays an 
icon in the action bar, it will use this icon. 


The icon can be a drawable or mipmap resource. A mipmap is an image that 
can be used for application icons, and they’re held in mipmap % folders in app/src/ 
main/res. as with drawables, you can add different images for different screen 

densities by adding them to an appropriately named mipmap folder. As an example, 
an icon in the mipmap-hdpi folder will be used by devices with high-density screens. 
You refer to mipmap resources in your layout using @mipmap . 

The android : label attribute assigns a user-friendly label to the app or activity, 
depending on whether it’s used in the 〈 application〉or <activity> 
attribute. The action bar displays the current activity’s label. If the current 
activity has no label, it uses the app’s label instead. 


f—— f[v\dyo\d S*tud»o testes 

dc-fault appl^a*tior\ \Cov\s \or 
you -fo\r 

deities. 0\&cc versions 

f[Y\d^o\d S*tudio \COY\S 

* m drawable -foldcv-s, ar\d 
灼 ev/ev vcv-s*io\r\s 'm 

七)化 -folders. 


The android : theme attribute specifies the theme. Using this attribute in 
the 〈 application〉element applies it to the entire app. Using it in the 
〈 activity〉element applies it to a single activity. 


Our android : theme attribute has the value " @ style/AppTheme ". The 
@style prefix means that the theme is defined in a style resource file. So 
what’s a style resource file? 
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Pefiwc styles iw style resource files 

A style resource file holds details of any themes you want to use. 

When you create a project in Android Studio, the IDE creates a default 
style resource file for you called styles.xml located in the app/sre/main/res/ 
values folder. It will look something like this: 

<resources> 

<!-- Base application theme.--> 

<style name= n AppTheme n parent= M Theme.AppCompat.Light.DarkActionBar n > 
<!-- Customize your theme here.--> 

</style> 

</resources> 




Pok \’ 七 wovvy i*f A^dv"oid S*tud ’。， 
V^as used a well 

i*t oy \ pay- 


The style resource file contains one or more styles. Each style is defined 
using the <style> element. 

Each style must have a name, which you define with the name attribute. 
The style must have a name so that the android : theme attribute 
in AndroidManifest.xml can refer to it. In our case, the style has a name 
of "AppTheme", so AndroidManifest.xml can refer to it using n @style/ 
AppTheme". 

The parent attribute specifies where the style should inherit its 
properties from. In the case above, this is " Theme. AppCompat. Light. 
DarkActionBar". 

You can also use the style resource file to customize the look of your app 
by modifying the properties of an existing theme. To do this, you add an 
<item> element to the <style> that describes the modification you 
want to make. As an example, here’s how you’d modify the theme so that 
all the activities have a red background: 


□ 

BitsAndPizzas 

app/sre/main 

L C] 


res 



styles.xml 


<resources> 

<style name="AppTheme" parent= "Theme.AppCompat.Light.DarkActionBar M > 
<item name=，▼ android : background" >#FFO 000</item> 


</style> 
</resources 〉 




TJjis tu\rhs -the b 此 kyouhds 

y 。 冰 adtivi-tics v-cd- 


We’re not going to go into detail about customizing themes here. If 
you want to learn more we suggest you look at the online reference 
documentation: http:/ / developer, android, com/guide/topics/ui/themes.html. 

On the next page, we’re going to change the theme used by the app. 
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Set the default theme iw styles.xml 


We’re going to change the app so that it uses Theme . Holo . Light 
by default, and switches to using Theme . Material. Light if the 
app’s running on API level 21. 


We’ll start by changing the default theme. To do this, open the style 
resource file styles.xml located in the app/sre/main/res/values folder. This 
is the default style resource file. By default, we want to use a theme of 
Theme . Holo . Light, so this needs to be reflected in the <style> 
attribute like this: 

<resources> 


□ 

BitsAndPizzas 


<style name= M AppTheme" parent="android:Theme.Holo.Light"> 

<!-- Customize your theme here.--> 

</style> 

</resources 〉 

Use a Material theme ov\ newer devices 


app/sre/main 


res 



styles.xml 


As you saw in Chapter 8, you can use different folder structures to get 
your app to use different resources at runtime. As an example, you saw 
how to get your app to use different layout files depending on the size 
of the device screen. 

Here, we need the app to use a different style resource depending on 
the API level the app’s running on. To get the app to use a particular 
resource if the app’s running on API level 21, we can create a new 
values-v21 resource file and add the resource to this folder. 


p 

BitsAndPizzas 


% 

I ( 3 J 

B Project 


k 

飞 Project 



To do this, create a new folder in the app/sre/main/res folder called -foldcv- i-f 


Youll -fmd »*b casicv 

^ -to add 
^ r IJ 一 ：C 一 . 




values-v21. Then copy the file styles.xml from the values folder, and paste 
it in the values-v21 folder. 

We want the app to use a Material theme if it’s running on API level 
21, so edit styles.xml in the values-v21 folder so that it uses a theme of 
Theme.Material.Light: 


{jo *tV)C 



iB 1 Packages 
•S 1 Android 
- Scopes - 

• Project Files 

• Problems 

• Production 

• Tests 


i d roil 
ain 






<resources> 

<style name= n AppTheme" parent="android:Theme.Material.Light' 

<!-- Customize your theme here.--> 

</style> l/Ve’ll use iWis ^ 

</resources 〉 


□ 

BitsAndPizzas 

L Q 

app/sre/main 

L a 


res 


dcvidc is \rurwr\m5 API level 2-1 



values-v21 


The style name we’re using in each style resource file should be the 
same, because this enables an appropriate theme to be used at runtime. 
Let’s see how. 


.\Zh 


styles.xml 
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What happens whew you ruw the app 



When you run the app. Android sees that it needs to apply the theme 
described by ©style/AppTheme. 


0 


\nj 

Android 


O 


I must use the style called 
AppTheme thafs the best 
fit for this device. 



If the apps running on API level 21, it uses the style called AppTheme in the 
values-21 folder. 

The style specifies a theme of Theme . Material. Light, so it applies this theme. 




Android 



values-v21 




styles.xml 


Name ： AppTheme 
Parent ： Tneme.Material.Light 



If the apps running on an API level below 21, it uses the style called 
AppTheme in the values folder. 

The style specifies a theme of Theme . Holo . Light, so this theme is applied instead. 


K 



O 


0 拉 


Test drive the app 


\nj 

Android 





val 


ues 




styles.xml 


Name ： AppTheme 
Parent ： Tneme.Holo.Light 


When you run the app, MainActivity has an action bar. If you 
run the app on a device that has API level 21, the app uses a theme of 
Theme . Material. Light. If you run the app on a device with a 
lower API level, it uses a theme of Theme . Holo . Light. 


16:06 


Bits And Pizzas 


Hello world! 


0v\ API Ic'/cl 2-1, it uses 


16:08 


Bits And Pizzas 

Hello world! 0vs a API level, it 

us ^ s TIiCr^c H'olo.Ligli-t. 
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Adding action items to the action bar 


Most of the time, you’ll want to add action items to the action bar. 
These are buttons or text in the action bar you can click on to make 
something happen. As an example, we’re going to add a “Create 
Order’’ button to our action bar. 



Well Oct^t a 
Cv-catc Order action 
bu*tW. 


To add action items to the action bar, you do three things: 

o Define the action items in a menu resource file. 

❺ Get the activity to inflate the menu resource. 

You do this by implementing the onCreateOptionsMenu () method. 

o Add code to say what each item should do when clicked. 

You do this by implementing the onOptions 工 temSelected () 
method. 

We’ll start with the menu resource file. 
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The mm resource file 

When you create a project containing an activity, Android Studio creates 
a default menu resource file for you. We told Android Studio to call this 
file menu—main.xml ， and it created it in the app/src/main/res/menu folder. All 
menu resource files go in this folder. 

Here’s the menu resource file Android Studio created for us. It describes a 
single Settings action item that appears in the action bar overflow: 



<menu xmlns : android= M http :// schemas.android.com/apk/res/android' 
xmlns : tools="http :// schemas.android.com/tools" 
xmlns : app= M http :// schemas.android.com/apk/res-auto n 
tools : context=".MainActivity"> 

BitsAndPizzas 



<item android : id= M @ + id/action settings" 

This is the 少 android: title= M @string/action_settings 

android:orderInCategory="100" 
app : showAsAction="never" / > 




</menu> 

Each menu resource file has a <menu> element at its root. A menu 
resource file defines a single menu, or set of items to be added to the action 


menu 



menu main.xml 


bar. Your app can contain multiple resource files, and this is useful if you 


want different activities to have different items on their action bars. 


Items are added to the menu using the <item> element. Each action item 
is described using a separate <item>. The <item> element has a number 
of attributes you can use, here are some of the most common ones: 


android:id 

Gives the item a unique ID. You need this in order to 
refer to the item in your activity code. 

android:icon 

The item’s icon. This is a drawable or mipmap resource. 

android:title 

The item’s text. This may not get displayed if your item 
has an icon if there’s not space in the action bar for both. 

If the item appears in the action bar’s overflow, only the 
text will be displayed. 

android: orderlnCategory 

An integer value that helps Android decide the order in 
which items should appear in the action bar. 


The code above uses another attribute, showAsAction. We’ll look at this 
on the next page. 
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The menu showAsAction attribute 


The showAsAction attribute is used to say how you want the 
item to appear in the action bar. As an example, you can use it to 
get an item to appear in the overflow rather than the main action 
bar, or to place an item on the main action bar only if there’s room. 
The attribute can take the following values: 


"ifRoom" 


"withText" 

"never" 

"always" 


Place the item in the action bar if there’s space. If there’s not 
space, put it in the overflow. 

Include the item’s title text. 

Put the item in the overflow area, and never in the main action bar. 

Always place the item in the main area of the action bar. This 
value should be used sparingly; if you apply this to many items, 
they may overlap each other. 


Let’s look again at the showAsAction attribute in the menu 
resource code. Notice how the showAsAction attribute is 
prefixed with app : not android : 

<menu xmlns : android= M http :// schemas.android.com/apk/res/android" 

xmlns : app="http : //schemas . android, com/apk/res-auto" 丁 i^s adds 

.. .> 


〈item android: id= M @ + id/action_settings" IP) d^d o\rdcV" I hC3*tc^V"Y 

android : title="@ string/action_settings , '^^ attributes use i\\t a^dvo'id 
android : orderInCategory=’'100 n _ _ ^ 〆 

app: sh OW AsAction=”n e ver’’ /> sKov/AsA^o^ uses i\)t aff 

</menu> 


Earlier in the chapter, you saw how our project had a dependency 
on the v7 appeompat library. The v7 appeompat library doesn’t 
include showAsAction in the android namespace. 

If your project has a dependency on the v7 appeompat library ， 
showAsAction must be prefixed with app : , and the <menu> 
element must include an attribute of 

xmlns : app= n http :// schemas.android.com/apk/res-auto" 

If your project has no dependency on the v7 appeompat library ， 
showAsAction must be prefixed with android : , not app : . 

You can also omit the attribute 


□ 

BitsAndPizzas 

HU 

app/sre/main 

L a 


res 



menu main.xml 


xmlns : app="http :// schemas.android.com/apk/res-auto" 


from the <menu> element. 
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Add a mvi action item 


We’re going to add a new item to the action bar for creating orders. The item 
will have a title of “Create Order’’ and an icon. 

When you use icons in your action bar, you can create your own or use 
icons from the Android action bar icon pack. The icon pack contains many 
standard icons you can use in your apps. 

We’re going to use the ic—action—new—event icon from the icon 
pack. First, download the icon pack from https://developer.android.com/design/ 
downloadsAndex.html. If you expand it, you’ll see there are many different icons 
for different themes and screen sizes. 



The ic action new event icons are located in the Action Bar Icons/ 


holo light/05 content new event folder. There are different icons for different 
screen sizes, indicated by their folder name. You need to copy the icons to 


appropriate folders in your project. Copy the icon in the drawable-hdpi folder to 
the draw able—hdpi folder in your project, and so on. 


Once you’ve added the icons, add a new action_create_order string 
resource to strings, xml: 


\( /Wdroid Studio seated 
■bhe -folders -for you, you II *to 
dv-ca*tc youv-scl-f- 


<string name= M action_create_order M >Create Order</string> ^ — IVcl! use this the 

adtioh iterws title. 


Then add the menu item to menu main. xml.. 


<menu xmlns : android= n http :// schemas.android.com/apk/res/android 
xmlns : tools= n http://schemas.android.com/tools" 
xmlns : app= n http :// schemas.android.com/apk/res-auto" 
tools : context=".MainActivity"> 


□ 


BitsAndPizzas 


〈item android : id= n @+id/action 一 create—order'▼ 

android:title= n @string/action create order' 


L Q 

app/sre/main 


res 


android : icon= n @drawable/ic action new event" 

android:orderInCategory= n l n "Nv IP_ 

: showAsAction="ifRoonT /> ^ * ，S as <>" MjH 

tnc action ba\r i 士 thc\rc s v-oom \oy ii. menu 

L 


app 


<item android : id="@+id/action—settings" 

android : title="@string/action_settings" 
android : orderInCategory="100" 
app : showAsAction= M never" / > 

</menu> 

Now that you’ve added action items to the menu resource file, you need to 
add the items to your action bar in your activity code. Let’s see how. 


|</ 


menu main.xml 
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Inflate the menu m the activity with 
the onCreateOptioHsMenuO method 

Once you’ve created a menu resource file, you add the items 
it contains to the action bar by implementing the activity’s 
onCreateOptionsMenu () method. It runs when the action 
bar’s menu gets created and takes one parameter, a Menu object 
representing the action bar. 

Here’s our onCreateOptionsMenu () method: 


package com.hfad.bitsandpizzas; 

import android• view.Menu; ^Tlic o^Cv-caicOp-tio^sMc^uO 

,.. rncihod uses 七 he Mc^u dass. 

public class MainActivity extends Activity { 


□ 


BitsAndPizzas 


pp/sre/main 

L a 


java 


com.hfad.bitsandpizzas 

\o**i 

D 

MainActivity.java 


… adds ^ m 

\rcsouv-tc -f ile *to kav- 

@Override ^ 

public boolean onCreateOptionsMenu(Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater().inflate(R.menu.menu 一 main, menu); 
return super.onCreateOptionsMenu(menu); 


You add items to the action bar using 


getMenuInflater().inflate(R.menu.menu main 

气 _ 


^ — ^ This ’is a Mcywa objed 七七 ha 七 
menu) ; vcfv-cscir>*ts 3d*tioir> bav*- 


This is "the v*csou\rdc -file- 


This takes the menu items in the menu_main.xml menu resource file, 
and adds them to the action bar Menu object. 


380 Chapter 9 










action bars 


React to action item clicks with the 
OHOptionsItemSelectedt) method 

You get your activity to react to when an action item in the action 
bar is clicked by implementing the onOptions ItemSelected () 
method. This method runs whenever an item in the action bar is 
clicked. 

The onOptions 工 temSelected () method takes one attribute, 
a Menu Item object that represents the item on the action bar that 
was clicked. You can use the Menu I tern’s getltemld () method 
to get the ID of the item on the action bar that was clicked so that 
you can perform an appropriate action, such as starting a new 
activity. 

Here’s the code for our onOptions I temSelected () method: 


package com.hfad.bitsandpizzas; 

,., Z— TV^C o\r\Op*b»or\s|*tcw>Sclc^*tcdO 

import android.view.Menultem; 1 ,.. 丄 

method uses dlass. 


□ 


BitsAndPizzas 


public class MainActivity extends Activity 


L L 3 

app/sre/main 

'Cl 


java 


The object is 七 he i*tcrw ov\ 

七 he achov\ bav 七 ha 七 was disked. 

@Override 

public boolean onOptionsItemSelected(Menultem item) { 

switch (item.getltemldO) { - - - item y/3s MtA 


com.hfad.bitsandpizzas 

p. 

MainActivity.java 



f[Y\dyo\d S*tud»o 
seated a SetUy 

•rtem -for us. You d 
fu 七 Code *to y 七 
"i*t *to do somdiimj 
V)C\rC. 

} 

} 


case R.id.action—create 一 order: 

//Code to run when the Create Order item is clicked 
return true; ^ 

case R. id.action 一 settings: ^ ^ ^ Order -to do sor^cthi^. 

//Code to run when the settings item is clicked 

return true; ^ br^t tells you^vc dealt v/*.*th iht be 吶 disked, 

default: 

return super.onOptionsItemSelected(item); 


We’re going to get the Create Order action item to start a new 
activity called Order Activity when it’s clicked. 
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Create OrderActivity 

We need to create a new activity called OrderActivity so our 
Create Order action item can launch it. 

Start by creating a new blank activity. Give it a name of 
“OrderActivity”，a layout name of “activity_order”，a title of 
^Create Order’’，and a menu resource name of u menu_order’’. 

Here’s the code for OrderActivity.java. Make sure that your code 
reflects ours. In particular, make sure that OrderActivity 
extends the Activity class and not ActionBarActivity. 
This is because you can only use one of the Theme . AppCompat 
themes with Act ionBar Activity, and we want to use the 
Holo and Material themes . 


package com.hfad.bitsandpizzas; 


import 

import 


public 


android.app.Activity; 

android.os.Bundle; 


Make sure 

v\oi 


V 


□ 


BitsAndPizzas 


class OrderActivity extends Activity { 


L Q 


QOverride 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—order); 


app/sr 4=l 


java 


com.hfad.bitsandpizzas 




OrderActivity.java 


We’ve not included the onCreateOptionsMenu () 
and onOptionsItemSelected () methods in our 
OrderActivity code, as we don’t need OrderActivity to 
display menu items from the menu resource file in its action bar. 
These methods would need to be added if we ever did want to 
display menu items. 

Now that we’ve created OrderActivity, let’s get the Create 
Order action item in Main Activity to start it. 
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Start OrderActivity with the 
Create Order action item 

We want to get the Create Order action item in the MainActivity 
action bar to start OrderActivity when it’s clicked. To do this, we 
need to update MainActivity 5 s onOptionsItemSelected () 
method. We’ll start OrderActivity using an intent. 

Here’s the code we need to change: 

package com.hfad.bitsandpizzas; 


import android • content • Intent; ^ dass. 


BitsAndPizzas 


public class MainActivity extends Activity { 

參參 

@Override 

public boolean onOptionsItemSelected(Menultem item) 
switch (item.getltemld()) { 

case R.id.action create order : 


L Q 

app/sre/main 


java 


com.hfad.bitsandpizzas 

Id 

//Code to run when the Create Order item is clicked MainActivity.java 


Intent intent = new Intent(this, OrderActivity.class); 

startActivity(intent); TKis \Y\itY\i is used bo siari 

return true; 七 |V| 七 '/ Cv*C3*tc 

case R• id • action—settings : OvAty 3d*tioy> rtem is £.|'idked- 

//Code to run when the settings item is clicked 
return true; 
default : 


return super.onOptionsItemSelected(item) 


When the Create Order action item is clicked, it will create an intent that 
starts OrderActivity. 

We’ll show you the full MainActivity.java code on the next page. 
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The full MaiwActivity.java code 


package com.hfad.bitsandpiz zas; 

import android.app.Activity; 
import android•content • 工 ntent; 
import android.os.Bundle; 
import android.view.Menu; 
import android•view.Menultem; 


public class MainActivity extends Activity 


QOverride 



BitsAndPizzas 



app/sre/main 



com.hfad.bitsandpizzas 

1_Q 

a 

MainActivity.java 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 

} 

Add rtcw>s -to action bav-. 

@Override 

public boolean onCreateOptionsMenu(Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater().inflate(R.menu.menu_main, menu); 
return super.onCreateOptionsMenu(menu); 


QOverride 

public boolean onOptionsItemSelected(Menultem item) { 
switch (item.getltemld()) { 

case R.id.action 一 create—order: 

//Code to run when the Create Order item is clicked 
Intent intent = new 工 ntent(this, OrderActivity.class); 
startActivity(intent); 个 

return true; 0\rdc\rActivity y/hch the 

case R• id• action—settings : Create Oirdcir itcrw is dlidkcd- 

//Code to run when the settings item is clicked 
return true; 
default : 

return super•onOptionsItemSelected(item); 
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Test drive the app 


When you run the app, a new Create Order action item is 
displayed in the MainActivity action bar. When you click 
on the action item, it starts Order Activity. 




Don’t worry if your 
action item doesn’t 
appear in the main 
action bar. 


The action item may appear in the 
overflow instead. This is due to a bug 
in some revisions of the v7 appeompat 
library. If this is a problem in your app, 
report it to Google. 



My app already includes a label 
and icon. Where did they come from? 

When you create an Android project 
using an IDE like Android Studio, the IDE 
creates a bunch of code for you. This 
includes things such as the app label and 
icon. 

Can you use action bars if you 
want to support an API below level 7? 

No, you can’t. This isn’t that big a 
deal, though, because very few devices run 
API level 7 or below. 



Why do I have to use 
ActionBarActivity if I want to 
support an API below level 11? 

You have to use the Android support 
library to add an action bar in this case. 

Would I ever want to use different 
themes for different API levels? 

You might. Material was introduced 
with API level 21, so you might want apps 
to use this theme if it’s available. 


You say you can apply themes to 
activities individually. Would I ever want 
to do that? 

Yes, you might. The Holo and 
Material themes have several subclasses 
of themes that give activities a slightly 
different appearance. If you want to give 
one of your activities a different look, you 
might want it to use a different theme. 
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sharing is caring 


Sharing cowtcwt ow the action bar 

The next thing we’ll look at is how to use an action provider with 
your action bar. An action provider is an item you add to your 
action bar that handles its own appearance and behavior. 

We’re going to concentrate on using the share action provider. The 
share action provider allows users to share content in your app with 
other apps such as Gmail. As an example, you could use it to let 
users send details of a particular pizza to one of their contacts. 

The share action provider defines its own icon, so you don’t have to 
add it yourself. When you click on it, it provides you with a list of 
apps you can use to share content. 


You share the content with aw intent 

To get the share action provider to share content, you pass it an 
intent. The intent you pass it defines the content you want to share, 
and its type. As an example, if you define an intent that passes text 
with an ACTION SEND action, the share action will offer you a list 
of apps on your device that are capable of sharing this type of data. 


TV^IS IS y/V^at sV^a^TC a 此 cm looks 
r,ke Oh i\\t 把 tiem bar. I/VV^ you 
c\\cV ov\ i*t> i*t jives you a 1'is-t o\ 

use "to sii3VC 




Your activity creates an intent and passes it to the share action provider. 

The intent describes the content that needs to be shared, its type, and an action. 


o 

YourActivity 


Intent 



ACTION—SEND 
type ：、、 text/plain" 
messageText ： ,, Hi! ,# 



ShareAction 

Provider 



When the user clicks on the share action, the share action uses the intent 
to present the user with a list of apps that can deal with it. 

The user chooses an app, and the share action provider passes the intent to the app’s activity 
that can handle it. 



ShareAction 

Provider 


Intent 



ACTION—SEND 
type ：、、 text/plain 〃 
messageText:’’Hi! 


AppActivity 
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Add a share action provider to mcwu_maiw.xml 


You add a share action to the action bar by including it in the 
menu resource file. 


To start, add a new action_share string to strings.xml. We’ll 
use it to add a title to the share action in case it appears in the 
overflow: 

<string name= M action share">Share</string> 


You add the share action to the menu resource file using the 
<item> element as before. This time, however, you need to 
specify that you’re using a share action provider. You do this by 
adding an attribute of android : actionProviderClass 
and setting it to android. widget. ShareActionProvider. 

Here’s the code to add the share action: 




BitsAndPizzas 


L Q 

app/sre/main 



res 



val 



strings.xml 


<menu xmlns : android="http :// schemas.android.com/apk/res/android 
xmlns : app= n http :// schemas.android.com/apk/res-auto" 


xmlns : tools="http :// schemas.android.com/tools 
tools : context:".MainActivity M > 

<item android : id="@+id/action—create—order" 

... /> 


□ 


BitsAndPizzas 


*~ r \ 

app/sre/main 

- _I 


res 



〈item android : id= n @+id/action 一 share” 

android: title= n @string/action 一 share’▼ 

android: orderInCategory=”2 ” p isp |ay adtioy> proVidcv 

i\\t athov\ bav- \( *thc\rcs \room. 


menu 

I_ 

menu main.xml 


app : showAsAction="ifRoom M < 一 — 
android : actionProviderClass="android.widget.ShareActionProvider n /> 

"T~liis is "the sli3\rc d 匕七 ioh P\ro\/id^* 

<item android:id= n @+id/action—settings n ' d ' 

... /> 

</menu> 


When you add a share action to your menu resource file, 
there’s no need to include an icon. The share action provider 
already defines one. 


Now that we’ve added the share action to the action bar, let’s 
specify what content to share. 
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intents again 


Specify the cowtewt with aw iwtewt 

To get the share action to share content when it’s clicked, you need 
to tell it what to share in your activity code. You do this by passing 
the share action provider an intent using its setSharelntent () 
method. Here’s how you’d get the share action to share some default 
text when it’s clicked: 


package com.hfad.bitsandpizzas; 


import android.widget.ShareActionProvider; 

public class MainActivity extends Activity { 

private ShareActionProvider ShareActionProvider 

... MA a SV)arcA^o^ov*»acv f'rWatc 

@ Over ride vavidklc* 


□ 

BitsAndPizzas 

1 - C3I 

app/sre/main 

-力 


java 


LTl 


com.hfad.bitsandpizzas 

F#T{| 

Q 

MainActivity.java 


public boolean onCreateOptionsMenu(Menu menu) { 

getMenuInflater()•inflate(R.menu•menu—main, menu); 

Menultem menultem = menu.findItem(R.id.action share); 


ShareActionProvider = (ShareActionProvider) menultem.getActionProvider(); 
setlntent("This is example text"); 

return super.onCreateOptionsMenu(menu); 


与 ei a -to -the sha\rc pvovidev* 

a^d assign i-t -fco -the pviva-tc variable- Then 
△all "the sc-ilr)-tcr\-iO meihod- 


private void setlntent(String text) { 

Intent intent = new Intent(Intent.ACTION—SEND); 

intent.setType("text/plain »)； 、後 Seated ihe se 七 l,Wt() me^od. 

intent • putExtra (Intent. EXTRA 一 TEXT, text) ; | 七 trta ^ s ^ … 七⑶七 , ad passes *rt 

ShareActionProvider. setSharelntent (intent) ; (一 ^ skav^e ad*t'ioy> pvovidcv* us'm^ 

} rts ⑶七 (） 


You need to call the share action provider’s setSharelntent () 
method whenever the content you wish to share has changed. As an 
example, if you’re flicking through images in a photo app, you need to 
make sure you share the current photo. 

We’ll show you our full activity code on the next page, and then we’ll 
see what happens when the app runs. 
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The full MaiwActivity.java code 


Here’s the full activity code for MainActivity.java : 


package com.hfad.bitsandpizzas; 


import 

import 

import 

import 

import 

import 


android.app.Activity; 

android.content.Intent; 

android.os.Bundle; 

android.view.Menu; 

android.view.MenuItem; 

android.widget.ShareActionProvider; 


public class MainActivity extends Activity 




□ 

BitsAndPizzas 

LQ 

app/sre/main 

L Q 


WleVc us*m^ 七 he 

^.lass ； so v/e *to 
•impov * 七 rt. 


java 



com.hfad.bitsandpizzas 

a 

MainActivity.java 


private ShareActionProvider ShareActionProvider; 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_main); 


QOverride 


public boolean onCreateOptionsMenu(Menu menu) { 

// Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater()•inflate(R.menu•menu—main, menu); 

Menultem menultem = menu.findItem(R.id.action share); 


ShareActionProvider = (ShareActionProvider) menultem.getActionProvider(); 
setlntent("This is example text") ; eat 

return super.onCreateOptionsMenu(menu) 

provide should skav-e. 

private void setlntent(String text) { ^ 


This sets -the default text 
that the sha\rc 


Intent intent = new Intent(Intent.ACTION—SEND); 
intent.setType("text/plain n ); 
intent.putExtra(Intent.EXTRA—TEXT, text); 
ShareActionProvider.setSharelntent(intent); 


todt dontmucs 

ovcv- pay. 
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The MainActivity .java code (continued) 

@Override 

public boolean onOptionsItemSelected(Menultem item) 
switch (item.getltemld()) { 


□ 

BitsAndPizzas 

L Q 

app/sre/main 

L Q 


case R.id.action_create_order : 

//Code to run when the Create Order item is clicked 
Intent intent = new 工 ntent(this, OrderActivity.class); 
startActivity(intent); 
return true; 


java 


com.hfad.bitsandpizzas 


a 


MainActivity.java 


case R.id.action 一 settings: 

//Code to run when the settings item is clicked 


return true; 
default : 


t , 

丁 Wis method 


return super•onOptionsItemSelected(item); 


Test drive the app 


When you run the app, the share action is displayed in the 
action bar. When you click on it, it gives you a list of apps to 
choose from that can accept the intent we want to share. When 
you choose an app, it shares the default text. 


七 he sha\rc adiio^ may appear 

m "the action ba\r ovc\r-Plov/ ms-tcad o-f 

"the ma'm av-ca o( -the adio 灼 bdv*. 



16:12 


Bits And Pizzas 

Hello world! 

TV^C mtcyrt WC passed 
■bo sV^av-c dck\ov\ 
pv-ov'idev- says y/c warrb 
■to sV^av-c usmj 

ACT 卿一 2 腑 It 、 

diisflays a list 

cav\ do *tWis. 
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action bars 


Enabling Up navigation 

If you have an app that contains a hierarchy of activities, you can 
enable the Up button on the action bar to navigate through the app 
using hierarchical relationships. As an example, MainActivity 
in our app includes an action item on its action bar that starts a 
second activity, Order Activity. If we enable the Up button on 
Order Activity’s action bar, the user will be able to return to 
MainActivity by clicking on it. 




<^o *to 七七 y. 




Up navigation may sound the same as using the Back button, but 
it’s different. The Back button allows users to work their way back 
through the history of activities they’ve been to. The Up button, on 
the other hand, is purely based on the app’s hierarchical structure. 


丁 he activity 


The 匕 hi Id a^tiv/rty. 




Uf biA*t*boy\ will *t3kc you ^ 
Uf i\\t V)'ic\ra\r^Y *to 
ad-twi-tys pav-c^i. 



Use tke Back tutton 
to navigate Lack to 
tke previous activity. 

Use tke Up button to 
navigate up tke app’s 
kierarcky. 


So that you can see this in action, we’re going to enable the Up 
button on Order Activity’s action bar. When you click on it, it 
will display MainActivity. 
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Setting an activity's parent 

The Up button enables the user to navigate up a hierarchy of activities 
in the app. You declare this hierarchy in AndroidManifest.xml by specifying 
the parent of each activity. As an example, we want the user to be able 
to navigate from Order Activity to MainActivity when they 
press the Up button, so this means that MainActivity is the parent of 
OrderActivity 


From API level 16, you specify the parent activity using the 
android : parentActivityName attribute. For older versions of 
Android, you need to include a <meta-data> element that includes 
the name of the parent activity. Here are both approaches in our 
AndroidManifest. xml: 


<?xml version="1.0" encoding= M utf-8"?> 

〈manifest xmlns : android= M http :// schemas.android.com/apk/res/android' 
package= M com.hfad.bitsandpizzas" > 

〈application 

android : allowBackup= M true n 
android : icon="@mipmap/ic_launcher" 
android : label= n @string/app_name" 
android : theme= n Qstyle/AppTheme" > 


□ 


BitsAndPizzas 


〈activity 


L Q 

app/src/main 

■ <^cml> j 


AndroidManifest.xml 


android : name=".MainActivity" 
android : label= M @string/app_name" > 
<intent-filter> 


<action android:name= n android•intent.action•MAIN" / > 
〈category android: name 二 ， , android • intent. category • LAUNCHER" / > 
</intent-fiIter> 

</activity> 


〈activity 


android : name= M .OrderActivity" 

android : label="@string/title_activity_order" 

android : parentActivityName= M .MainActivity"> 
<meta-data 


Apps a*t API level l^> ov- above us ， 七 Wis 
l*mc. I*t says s 

pav"cir\*t 


android : name= M android.support.PARE] 
android : value= n .MainActivity" /> 


</activity> 

</application 〉 

〈 /manifest 〉 

Finally, we need to enable the Up button in OrderActivity. 


/ou ohly heed b> add the <^tia-daia> 
clcmcht i-P youVc suppov-tmg apps below API 
Icvc l^>. IVcvc ohly ihduded it so you W w 
what it looks like, ahd i^ludmg it docs^i dc 
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Adding the Up buttow 

You enable the Up button from within your activity code. 
You first get a reference to the action bar using the activity’s 
getActionBar () method. You then call the action bar’s 
setDisplayHomeAsUpEnabled () method, passing it a 
value of true. 



If you enable the 
Up button for an 
activity, you must 
specify its parent. 


ActionBar actionBar = getActionBar(); 
actionBar.setDisplayHomeAsUpEnabled(true); 

We want to enable the Up button in Order Activity, so we’ll 
add the code to the onCreate () method in Order A ctivity.java. 
Here’s our full activity code: 


If you don’t ， 
you’ll get a null pointer 
exception when you call the 
setDisplayHomeAsUpEnabled() 
method. 


package com.hfad.bitsandpizzas; 


import 

import 

import 


android.app.ActionBar; 

android.app.Activity; 


〆 


£.ldss, so y/C y\ttA *to 七 it 


android.os.Bundle; 


□ 


BitsAndPizzas 


public class OrderActivity extends Activity { 

QOverride 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 


413 

app/src/main 

L Q 



setContentView(R.layout.activity—order); 

ActionBar actionBar = getActionBar(); 
actionBar.setDisplayHomeAsUpEnabled(true); 


com.hfad.bitsandpizzas 

山 “ F*«(| 

OrderActivity.java 


\This enables the Up buttoh 
… tKc bar. 


Let’s see what happens when we run the app. 
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test drive 

Test drive the app 

When you run your app and click on the Create Order action 
item, OrderActivity is displayed as before. 



C\\cV ov\ Create 
Ov-dcv- button 
s*tav-t Ov-dcv-A^Wi-by. 


<- Order Activity 




OrderMh^b/ ihdludes av\ 

Wp button. I/Vhch you dl'utk 
Oh it... 


Bits And Pizzas 






Hello world! 


… 七 Y’ s favwt 
•is displayed- 



OrderActivity displays an Up button in its action bar. When 
you click on the Up button, it displays its hierarchical parent 
MainActivity. 



394 Chapter 9 






















action bars 



Your Android Toolbox 

You’ve got Chapter 9 under 
your belt and now you’ve 
added action bars to your 
toolbox. 


You download 
-full code ^ov 

rtcadP»v-s*tA^dv-o*id. 



BULLET POINTS 


■ To add an action bar to apps supporting API 
level 11 or above apply one of the Holo or 
Material themes. 


■ 


■ 


■ 


■ 


■ 


Add an action bar to apps supporting 
API level 7 or above by applying an 
AppCompat theme and using the 

ActionBarActivity class. If you use 
ActionBarActivity, you must use 
an AppCompat theme. 

Ac tionBar Activity and the 

AppCompat themes are in the v7 appeompat 
support library. 

The android : theme attribute in 
AndroidManifest.xml specifies which theme 
to apply. 

You define styles in a style resource file 
using the 〈 style 〉 element. The name 
attribute gives the style a name. The 
parent attribute specifies where the style 
should inherit its properties from. 

The default folder for style resource files 
is app/src/main/res/values. Put a style 
resource file in the app/sre/main/res/ 
values-v21 folder if you want it to be used on 
API level 21. 


■ 


■ 


■ 


■ 


■ 


Add action items to your action bar by adding 
items to a menu resource file. 

Add the items in the menu resource 
file to the action bar by implementing the 
activity’s onCreateOptionsMenu () 

method. 

Say what items should do when 
clicked by implementing the activity’s 

onOptionsItemSelected() 

method. 

You can share content by adding the share 
action provider to your action bar. Add it by 
including it in your menu resource file. Call 
its setSharelntent () method to pass 
it an intent describing the content you wish 
to share. 

Add an Up button to your action bar to navigate 
up the app's hierarchy. Specify the hierarchy in 
AndroidManifest.xml. Use the ActionBar 
setDisplayHomeAsUpEnabled() 
method to enable the Up button. 


SAFm 9 
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10 naVIgcttipn drawers 




Going Places ♦ 



I know III never get lost 
so long as I have my lucky 
navigation drawers. 


Apps are so much better when they’re easy to navigate. 

In this chapter, we’re going to introduce you to the navigation drawer, a slide-out panel 
that appears when you swipe the screen with your finger or click an icon on the action bar. 
We’ll show you how to use it to display a list of links that take you to all the major hubs 
of your app. You’ll also see how switching fragments makes those hubs easy to get to 
and fast to display. 


this is a new chapter 









more pizza 


The Pizza app revisited 


In Chapter 9, we showed you a sketch of the top-level screen of the 
Pizza app. It contained a list of options to places in the app the user 
could go to. The first three options linked to category screens for pizzas, 
pasta, and stores, and the final option links to a detail/edit screen where 
the user could create an order. 


Bits and piaoiS 


Pizzas 


TV^'is is Piz^a aff 


Pols 七 


Stores 



Create Order 


"TKcsc lihk sdvcchs. 


•TWis -takes you -to a dtia\Vtd\i s ⑽於 士代 
you cav\ dv-catc a ^ ov-dev-. lA/c moved 
-to adt»oir\ bay - \ y \ % 


So far you’ve seen how you can add action items to the action bar. This 
approach is best used for active options such as creating an order, but 
what about the category screens? As these are more passive and used for 
navigating through the app, we’ll take a different approach. 

We’re going to add the Pizzas, Pasta, and Stores options to a 
navigation drawer. A navigation drawer is a slide-out panel that 
contains links to the main parts of the app. These main parts are called 
the major hubs of the app, and they are typically the main navigation 
points within the app — the top-level screens and the categories: 


T\)\s is i\\t nav'ija-bio^ 

drawer. It do^ta'ms i\\t 

majoV" Kubs o-f app. 


6'\+s and Pizzas : 

Home 

rr^ — 

Pizzas 

Pols 七 a 

Scores 



I/Vkh you didk Oh item ih the 

^avigatioh draper, the dohtch-t 
•f 。 浐 that optioh is displayed h 的 . 
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navigation drawers 


Navigation drawers deconstructed 


You implement a navigation drawer using a special type of layout 
called a DrawerLayout. The Drawer Layout manages two views: 

o A view for the main content. This is usually a FrameLayout so that 
you can display and switch fragments. 

o A view for the navigation drawer, usually a ListView. 

By default, the DrawerLayout displays the view containing the 
main content. It looks just like a normal activity: 


10:52 


TV^'is is i\\c r\av*i5atioy\ drawer ^ 

化 cm. Ckk cm it 饮 sy/*ifC your 

-fmyv" *to opcir\ dv" 



When you click on the navigation drawer icon or swipe your finger 
from the edge of the screen, the view for the navigation drawer slides 
over the main content: 


包 . 


10:54 


This is ihc ^avi^a-tiort 一 ^ 
dv-av/c\r. li a 

lis-t of options. 

令 Bits And Pizzas 

Home 

Pizzas 


Pasta 


Stores 


The dva>wcv- 
slides ovcv 七 he 
mam 


This content can then be used to navigate through the app. 
So how does this affect the structure of the Pizza app? 
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The Pizza app structure 

We’re going to change MainActivity so that it uses a drawer layout. 
It will contain a frame layout for displaying fragments, and a list view to 
display a list of options. 

The list view will contain options for Home, Pizzas, Pasta, and Stores 
so that the user can easily navigate to the major hubs of the app. We’ll 
create fragments for these different options. This means that we’ll be 
able to switch the fragments at runtime, and the user will be able to 
access the navigation drawer from each of the different screens. 



PastaFragment StoresFragment 


Here are the steps we’ll go through to do this: 


o 

o 

o 

o 


Create fragments for the major hubs. 

Create and initialize the navigation drawer. 

The navigation drawer will contain a ListView displaying the list 
of options. 

Set the ListView to respond to item clicks. 

This will allow the user to navigate to the major hubs of the app. 

Add an ActionBarDrawerToggle. 

This lets the user control the drawer through the action bar and 
allows the activity to respond to drawer open and close events. 


We’ll start by creating the fragments. 


o 


Adding a 
navigation 
drawer 
takes a lot 
of code. 

We’re going to spend the rest of 
the chapter showing you how to 
add one, and we’ll show you the 
entire MainActivity.java code at 
the end. 
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Create TopFragmewt 


We’ll use TopFragment to display the top-level content. For now, 
we’ll use it to display the text “Top fragment” so that we know which 
fragment we’re displaying. Create a new blank fragment with a fragment 
name of TopFragment and a layout name of fragment_top. 

Here’s the code for Top Fragment.java\ 

package com.hfad.bitsandpizzas; 


import android.os.Bundle; 
import android.app.Fragment; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup; 


navigation drawers 

Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


1/VcVc us'm^ a blank 乎⑶七 -fov- all o( ouv 
as v/cVc *to vcfladc all 七 k 

toAt h^o\A Studio ^traits, (or us. 

BitsAndPizzas 

app/sre/main 
java 



public class TopFragment extends Fragment 


To P F^ 3 r ， e，tjava is a plai, com.hfad.bitsandpizzas 

F»T(1 

a 

TopFragment.java 

@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

return inflater.inflate(R.layout.fragment top, container, false); 


Add the following string resource to strings.xml; we’ll use this in our 

fragment layout: Add *tWis -to Well use 

〈string name:"title 一 top”>To P fragment/string> ^ \s 平 d. 

Here’s the code for fragment_top.xml: 

<RelativeLayout xmlns : android= M http : //schemas.android.com/apk/res/android" 


xmlns : tools= n http://schemas.android.com/tools M 
android : layout__width= "match_parent" 
android : layout_height= M match_parent n 
tools : context:”.MainActivity"> 

<TextView 

android : text= n @ string/1itle—top n 
android : layout_width= n wrap—content” 
android : layout_height= n wrap_content" /> 
</RelativeLayout> 


□ 


BitsAndPizzas 



app/sre/main 


res 


□ 


layout 

fragment_top.xml 


you are here ► 


401 




















create PizzaFragment 


Create PizzaFragmcwt 

We’ll use a ListFragment called PizzaFragment to display the 
list of pizzas. Create a new blank fragment with a fragment name 
of PizzaFragment, and untick the option to create a layout. This is 
because list fragments don’t need a layout — they use their own. 

Next, add a new string array resource called “pizzas” to strings.xml 
(this contains the names of the pizzas): 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


<string-array name= n pizzas n > 


<item>Diavolo</item> 


<item>Funghi</item> 
</string-array> 


Add tk a^nray of piz^s io sVmgs.^l. 


Then change the code for PizzaFragment.java so that it’s a 
ListFragment. Its list view should be populated with the pizza 
names. Here’s the code: 


package com.hfad.bitsandpizzas; 


□ 

BitsAndPizzas 


import 

import 

import 

import 

import 

import 

public 


android.app.ListFragment; 
android.os.Bundle; 
android.view.Layoutlnflater; 
android.view.View; 
android.view.ViewGroup; 
android.widget.ArrayAdapter; 


L n 

app/sre/main 



\/\/e || use a UstFrajmcnt *to 

list o*f 


display 


java 


com.hfad.bitsandpizzas 

I leU». 

a 


class PizzaFragment extends ListFragment { 


PizzaFragment.java 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 
inflater.getContext(), 
android.R.layout.simple_list—item—l, 
getResources().getstringArray(R.array.pizzas)); 

setListAdapter(adapter); 

return super.onCreateView(inflater, container, savedlnstanceState); 
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Create PastaFragmcwt 

We’ll use a ListFragment called PastaFragment to display the 
list of pasta. Create a new blank fragment with a fragment name of 
PastaFragment. You can untick the option to create a layout as list 
fragments use their own layouts. 

Next, add a new string array resource called “pasta” to strings.xml (this 
contains the names of the pasta): 

<string-array name="pasta n > 

<item>Spaghetti Bolognese</item> Add the avv-ay o( pasta "to sVmgs.xml. 
<item>Lasagne</item> 

</string-array> 

Then change the code for PastaFragment.java so that it’s a 
ListFragment. Its list view should be populated with the pasta 
names. Here’s the code: 


package com.hfad.bitsandpizzas; 


□ 

BitsAndPizzas 


import 

import 

import 

import 

import 

import 


public 


android.app.ListFragment; 
android.os.Bundle; 


android.view.Layoutlnflater; 
android.view.View; 


android.view.ViewGroup; 
android.widget.ArrayAdapter; 


j/\/e || use a *to 

display list fasta. 


class PastaFragment extends ListFragment { 


app/sre/main 

L a 


java 


□ 


com.hfad.bitsandpizzas 



PastaFragment.java 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String> ( 
inflater.getContext(), 
android.R.layout.simple_list—item_l, 
getResources().getStringArray(R.array.pasta)); 

setListAdapter(adapter); 

return super.onCreateView(inflater, container, savedlnstanceState); 
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Create StoresFragmcwt 

We’ll use a ListFragment called StoresFragment to display the 
list of pasta. Create a new blank fragment with a fragment name of 
“StoresFragment.” Untick the option to create a layout as list fragments 
define their own layouts. 

Next, add a new string array resource called “stores” to strings.xml (this 
contains the names of the stores): 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


<string-array name="stores M > 

<itenOCambridge</item> a j j n o , 

<itenC>Sebastopol</itern> Add ^ ^ ^ ^ 如呼一 . 


</string-array> 

Then change the code for StoresFragment.java 各 o that it’s a 
ListFragment. Its list view should be populated with the store names. 
Here’s the code: 


package com.hfad.bitsandpizzas; 


□ 

BitsAndPizzas 


import 

import 

import 

import 

import 

import 


public 


android.app.ListFragment; 
android.os.Bundle; 
android.view.Layoutlnflater; 
android.view.View; 
android.view.ViewGroup; 
android.widget.ArrayAdapter; 


use a -to 

displav list s*toV"CS. 

ir 

class StoresFragment extends ListFragment { 



com.hfad.bitsandpizzas 

Q 

StoresFragment.java 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

ArrayAdapter<String> adapter = new ArrayAdapter<String>( 
inflater.getContext(), 
android.R.layout.simple_list—item—l, 
getResources().getstringArray(R.array.stores)); 

setListAdapter(adapter); 

return super.onCreateView(inflater , container, savedlnstanceState); 
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Add the PrawcrLayout 


Next, we’ll change the layout of MainActivity.java so that it uses a 
Drawer Layout. As we said earlier, this will contain a FrameLayout 
that will display fragments, and a ListView for the navigation drawer. 

You create the Drawer Layout using code like this: layout uses Pvawcv-Layou*t -fvom 

^ suffovt libvavy- The afptompax 

〈 android, support. v4 .widget.DrawerLayout libv*dv*Y mdludcs vn" suffov ■七 librav-y. 

xmlns : android:’▼ http: / /schemas . android. com/apk/res/android" 
android: id= n @+id/drawer—layout” 
android:layout_width= M match_parent" 
android:layout— height= n match_parent n > 


The FvamcLayoui v/ill be used bo display -Pv-ajmc^ts. 


<FrameLayout 


android: layout_width= M match_^parent" 
android:layout_height= n match_parent" 
… /> 

<ListView 

android:1ayout_width= n 2 4 0dp" 

android:layout_height= n match_parent n 

... /> 

</android.support.v4.widget.DrawerLayout> 


TKc dcsdvibcs *thc dva>wcv-. 


The DrawerLayout is the root component of the new layout. That’s 
because it needs to control everything that appears on the screen. 

The DrawerLayout class comes from the v4 support library, so 
we use its full class path of android. support. v4 . widget. 
DrawerLayout. 

The first element in the DrawerLayout is used to display the content. 
In our case, this is a FrameLayout that we’ll use to display fragments. 
You want this to be as large as possible, so you set its layout_width 
and layout_height attributes to ’ ’match 一 parent 

The second element in the DrawerLayout defines the drawer itself. 

If you use a ListView, this will display a drawer that contains a list 
of options. You usually want this to partially fill the screen horizontally 
when it slides out, so you set its layout—height attribute to 
n match_parent n and its layout_width attribute to a fixed width. 

We’ll show you the full code for activity—main.xml on the next page. 



TV^c temteyrt joes a 
Fv-amcLayoiA-t. Yo^ … 3 灼七 

C.or\*tcy\*t *to -f ill , 

sCXtt^ w>omdr\*t) *i*ts 


pav-t»ally Widden by 
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layout code 


The full code for activityjwaiw.xml 


Here’s the full code for activity_main.xml: 


\/ 


Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


<android.support.v4.widget.DrawerLayout 

xmlns : android: n http://schemas.android.com/apk/res/android '， 
android : id= n @+id/drawer_layout" 
android : layout_width= n match_parent n 
android : layout_height= M match_parent"> 


BitsAndPizzas 



<FrameLayout 

android : id= n @+id/content—frame 
android : layout_width="match_parent 
android : layout—height="match_parent n /> 


y/ill be 

displayed m 七 he 

fVa 你 e Layou 七 . 


app/sre/main 


res 


r*v- 


layout 



<ListView android:id= n @+id/drawer n 

android: layout_width= n 24Odp" 如 awev wuitVv 

android : layout_height= n match_^parent M 

android: layout—gravity= n start” ^ - lVV>cv-c b> fldde dhra>wcv". 

android:choiceMode= n singleChoice n Select o^e ’rterw a-t d -time- 
android : divider=" @ android: color/transparent ▼’ 

android : dividerHeight= n Odp n od 七 ^ dividcv - lines i'tcw'S 3hd 

android : background: "#ff ffff n 
</android.support.v4.widget.DrawerLayout> 




activity_main.xml 


sc*t 七 k bddk^v~ouir>d dolov* o( 七 he dvdwev. 


Take a careful note of the settings we’re using with the <ListView> 
element, as any navigation drawer you create is likely styled in a 
similar way. 

To set the size of the drawer, you use the layout—width and 
layout—height attributes. We’ve set layout—width to “240dp” 
so that the drawer is 240dp wide when it’s open. 

Setting the layout_gravity attribute to "start" places the 
drawer on the left in languages where text runs from left to right, and 
places it on the right in countries where text runs from right to left. 

The divider, dividerHeight, and background attributes 
are used to switch off divider lines between the options and set the 
background color. 

Finally, setting the choiceMode attribute to "singleChoice" 
means only one item can be selected at a time. 



If your project 
doesn’t include 
a dependency 
on the v7 
appeompat 


support library, the 
navigation drawer code in 
this chapter won’t work. 


You manage dependencies 
by navigating to File—Project 
Structure—App—Dependencies. 
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navigation drawers 


Initialize the drawer's list 


Now that we’ve added a drawer layout to activity—main.xml ， we need to 
specify its behavior in MainActivity.java. The first thing we’ll do is populate 
the list view. To do this, we’ll add an array of options to strings.xml. We’ll 
then use an array adapter to populate the list. 


Here’s the array of strings you need to add to strings.xml (each item in the 
array refers to which fragment you want to display when it’s clicked): 


□ 

BitsAndPizzas 


<string-array name= M titles M > 


< i tem>Home< / i tem> 
<item>Pizzas</item> 

< i tem>Pas t a< / i tem> 


TV^csc av-c options 七 1 ^七 v/’ll be 
disflaycd *m hav^atio^ draper. 

Add the a 代 ay *to 


< i tem>S to res</i tem> 


4 U 

app/sre/main 


res 



</string-array> 


We’ll populate the list view in MainActivity.java^ onCreate () method. 
We’ll use private variables for the array and list view as we’ll need these 
later on. Here’s the code: 


val 



strings.xml 


WicVc us'm^ *t^csc 

import android. widget. ArrayAdapter 山说 s , so …⑽ dl ^ BitsA^zas 

import android.widget.ListView; irwfovt Ln 


public class MainActivity extends Activity { 

參 • • 

private String [] titles; ^ - I/Vcll use these m o-thev- methods 

private ListView drawerList; oh, so add tkem as private 

dass variables. 

QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


app/sre/main 

L a 

java 


com.hfad.bitsandpizzas 

O 

MainActivity.java 


titles = getResources().getstringArray(R.array.titles); 
drawerList = (ListView)findViewById(R.id.drawer); 
drawerList.setAdapter(new ArrayAdapter<String>(this, 

android.R.layout.simple_list_item_activated—l, titles)); 
} > ' 一 


Use an *to 

fofula-tc UsWiew. 


^ sm 5 means 七 ha 七 

七 he i-tem the usc\r dlidks is 


Now that we’ve populated the list view with a list of options, we’ll get the 
list to respond to item clicks. 
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respond to clicks 


Use an OwltcmClickListewcr to respond 
to clicks m the list view 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


You get the list view to respond to clicks in the same way that we did 
in Chapter 6, by using an onl temClickListener. We’re going 
to create the listener, implement its onltemClick () method, and 
assign the listener to the list view. Here’s the code: 


import android.view.View; 


WcVc lAs'mj 


import android.widget.AdapterView; 


^ dlasscs, so we tittA *to 


impo\rt 

public class MainActivity extends Activity { 


□ 

BitsAndPizzas 

L Q 

app/sre/main 


java 


com.hfad.bitsandpizzas 



ID 

MainActivity.java 


This dcsdHbcs the OhltcmClidkLis^chcv. 

Vr 

private class DrawerltemClickListener implements ListView.OnltemClickListener { 
@Override 


public void onltemClick(AdapterView<?> parent, View view, int position, long id){ 
//Code to run when the item gets clicked 

} t 

W\\tY\ USCV- t\\cks OY\ air> \Y\ MViytlO 朽 

dv-av/cv*, oir>|*tcr«ClidkO method yts 乙 ailed. 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 



drawerList.setOnltemClickListener(new DrawerltemClickListener()); 
Add a v\cyN *ms-br>tc o-P ou\r ^MiemClidkLis 七 "to 七 he Lisi\/icv/. 


The onltemClick () method needs to include the code you want to 
run when the user clicks on an item in the list view. We’ll get it to call a 
new selectltem () method, passing in the position of the selected 
item. We’ll write this method next. 


The method should do three things: 


o 

o 

o 


Switch the fragment in the frame layout. 

Change the title in the action bar to reflect the layout. 

Close the navigation drawer. 


You already know everything you need in order to do the first of these 
tasks, so have a go at the exercise on the next page. 
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Code Magnets 


When the user clicks on an item in the navigation drawer list view, we need 
to display the correct fragment in the content—frame frame layout. See 
if you can finish the code below. 


private void selectltem(int position) 
Fragment fragment; 

switch( ) { 

case 1 : 


fragment 

break; 


case 2 : 

fragment 
break; 
case 3 : 

fragment 
break; 
default : 

fragment 


TV^CSC av-C ^ 



^eginTransaction () 



^position ] 



TopFragment() 


J new I 



StoresFragment() 



「 new j 


FragmentTransaction ft = getFragmentManager(). 


ft.replace(R.id.content frame. 


ft.addToBackStack(null); 

ft•setTransition(FragmentTransaction•TRANSIT FRAGMENT FADE) 


ft. 
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magnets solution 



Code Magnets Solution 


When the user clicks on an item in the navigation drawer list view, we need 
to display the correct fragment in the content—frame frame layout. See 

if you can finish the code below. . ^ 

av-c i 七 ems ’ 

*m L'isWicvj. 


private void selectltem(int position) { 

Fragment fragment; 

____ - Chcdk Position *m dv-a>wcv- s 

I position ^ ) I L*is*t\/ic>M oi* v/3s disked. 



switch( 
case 


fragment 
break; 
case 2 : 

fragment 
break; 
case 3 : 

fragment 
break; 
default : 

fragment 



PizzaFragment() | 


Create a type o-P 心，⑶七 
ihat’s app\rop\riatc -Pov the 
fosi-tioh. l-p the usev- dlidks 
° h “Pizzas' *Po\r example, 




new I StoresFragment() H . 


I - u I - - l U ^ Bv default Ort^it a Tof FVa” ⑶七 . 

new I TopFragment() I . 1 


FragmentTransaction ft = getFragmentManager(). 

i - k ^ 

ft . replace(R.id.content—frame, 1 fragmentj ) ； Bcgi, a 

t\rahsad-tioh -fco \rcpladc the 

ft.addToBackStack(null); -Piragmch-t that’s displayed. 

ft•setTransition(FragmentTransaction•TRANSIT FRAGMENT FADE); 


ft. 


commit () | • Commit *thc *tvair>sad*t*ior>. 
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navigation drawers 


The sdectltcmO method so far 

Here’s our revised MainActivity.java code (when an item in the 
navigation drawer gets clicked, it calls the select Item (), which 
method displays a fragment): 

镰參參 

import android.app.Fragment; 

import android.app.FragmentTransaction; 


public class MainActivity extends Activity { 


□ 


BitsAndPizzas 


app/sre/main 



java 



com.hfad.bitsandpizzas 

1_Q 

D 

MainActivity.java 


private class DrawerltemClickListener implements ListView•OnltemClickListener { 
QOverride 

public void onltemClick(AdapterView<?> parent. View view, int position, long id) 

selectltem (position) ; Ca „ ^ se | e 出七加 0 

} yts disked- 


private void selectltem(int position) { 
Fragment fragment; 
switch(position) { 
case 1 : 

fragment = new PizzaFragment(); 
break; 
case 2: 

fragment = new PastaFragment(); 
break; 
case 3 : 

fragment = new StoresFragment() 
break; 
default : 

fragment = new TopFragment(); 


Ci^cdk position o-f dlidked. 


Use the positioh h> the Hftht type 

The Tiizas” option is at 
posi-tioh I, -fo\r \v\siaut, so ih this dasc 


Cv*ca*tc 3 by 七 


FragmentTransaction ft = getFragmentManager().beginTransaction(); 
ft.replace(R.id.content—frame, fragment); 
ft.addToBackS tack(null); 

ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 
ft.commit(); 今 

Wsc tmahsadtioh -to v-cpladc 

七 he -rv-agmch-t that’s displayed. 


Now that the selectltem () method displays the correct fragment, 
we’ll get it to change the action bar title. 
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change title 


Changing the action bar title 

In addition to switching the fragment that’s displayed, we need to 
change the title of the action bar so that it reflects which fragment 
is displayed. By default, we want the action bar to display the name 
of the app, but if the user clicks on the Pizzas option, for example, 
we want to change the action bar title to “Pizzas”. This will help the 
user know where they are in the app. 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


To do this, we’ll use the position of the chosen item to get the title 
that should be displayed from the titles array. We’ll then update the 
action bar title using the ActionBar setTitle () method. We’ll 
put this in a separate method as we’ll need it later on. Here’s the 
code: 


private void selectltem(int position) { 

• 參 * 

//Set the action bar title 

setActionBarTitle (position) ; Call 七 he sc*tA^t'Oir\Ti*tl) 


□ 


BitsAndPizzas 


fassmj *rt fositiem 
item was c\\cktd on. 


L d 

app/sre/main 

lb 


java 


private void setActionBarTitle(int position) { 

• a . UU 

String title; 1+ the usc\r dlidb oy\ 七 he option, use 

if (position == 0) { y -Po\r ihc tiilc. 

title = getResources().getString(R.string.app—name); 

} else { 

title = titles [position] ; ^ 

j *tV>c position 七 ha 七 v/as dlidked and >wse 

getActionBar() . setTitle (title) ; ^ Display 七心 Wc m the 3^ bav-. 


com.hfad.bitsandpizzas 


I leUn 

Q 


MainActivity.java 


10:52 


11:11 


=Bits And Pizzas 

Top fragment 




|-f i\\t usc\r c\\cks OYX W ttomC W 
option, display *m 

adt»or\ bav-. 
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Closing the Havigation drawer 


The final thing we’ll get the select Item () code to do is 
close the navigation drawer. This saves the user from closing it 
themselves. 

You close the drawer by getting a reference to the 
Drawer Layout and calling its closeDrawer () method. 
The closeDrawer () method takes one parameter, the View 
that you’re using for the navigation drawer. In our case, it’s the 
ListView that displays the list of options: 

private void selectltem(int position) { 


□ 


BitsAndPizzas 


app/sre/main 

L Q 

java 

MU 

com.hfad.bitsandpizzas 


a 


//Close the drawer 


MainActivity.java 


6\t{, a *to Pv-av/cv-Layout 

DrawerLayout drawerLayout = (DrawerLayout) findViewByld(R.id.drawer_layout); 
drawerLayout. closeDrawer (drawerList) ; t 1 — dv-av/ev-List is ihc Dv-awcv-Lavou^s dv-av/cv-. This idls 


ayou^s 

"tW "to lose 七 he dv~av/^rL-is 七 dv*3v/cv*. 


10:54 


The Chti\rc SdV-CCh is 

"the Pvav/cv-Layout. H — 
a Fv-a^cLayout 
the dohtch-t goes, 

3 Listl/icw which 
used -fo\r the dv-awcv-. 


>u y\ttd bo *tcll 
Pva>wcv-Layou*t *to dlosc 
•rts L*is*t\/'iC>w dv-a>wcv-. 



Now that you’ve seen all the components needed for the 
selectltem () code, let’s look at the full code and how it’s 
used in MainActivity. 
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MainActivity code 


The updated MaiwActivity.java code 

Here’s the updated code for MainActivity.java : 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


package com.hfad.bitsandpizzas; 


□ 

BitsAndPizzas 

L u 

app/sre/main 

Pv-av/cv-Layou*t is m L a 

java 



import android. support. v4 . widget. DrawerLayout; ^ VT suffov * 七 


public class MainActivity extends Activity { com.hfad.bitsandpizzas 

… r* j 

private DrawerLayout drawer Lay out; ^ Add Dv3wc\rL-3you*t. 3s 3 p\riv3*t.c V3vi3blc ； MainActivity.java 

3s v/c II use i*t m multiple methods. 

private class DrawerltemClickListener implements ListView•OnltemClickListener { 
QOverride 

public void onltemClick(AdapterView<?> parent. View view, int position, long id) { 
//Code to run when an item in the navigation drawer gets clicked 
selectltem (position) ; _ ^|| select I tcw'O method. 




QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—main); 

titles = getResources().getStringArray(R.array.titles); 
drawerList = (ListView)findViewByld(R.id.drawer); 

drawerLayout = (DrawerLayout) findViewByld(R.id.drawer 一 layout); 

// Populate the ListView 

drawerList.setAdapter(new ArrayAdapter<String>(this, 

android•R•layout•simple_list_item_activated—1, titles)); 
drawerList•setOnltemClickListener(new DrawerltemClickListener()); 

if (savedlnstanceState == null) { 

selectltem(O) ; ^ ^ ^ seated, use i\vc 

} display 


与 ei a b> 七 he 

Dv*av/cvLayoui. 


TV^C Code doir\*t'muCS ^^^ 
OY\ 
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The MaiwActivity.java code (contmued) 

private void selectltem(int position) { 

// update the main content by replacing fragments 
Fragment fragment; 

switch(position) { *to display* 


case 1 : 

fragment 
break; 
case 2 : 

fragment 
break; 
case 3 : 

fragment 
break; 
default : 

fragment 




new PizzaFragment(); 


new PastaFragment(); 


□ 

BitsAndPizzas 

413 

app/sre/main 

L dl 

java 


new StoresFragment() 


new TopFragment(); 


Display 七 he us’mg a 

*r\raArwCh-t -t\ra^sad-tioK>. 


com.hfad.bitsandpizzas 

13 

MainActivity.java 


FragmentTransaction ft = getFragmentManager().beginTransaction(); 
ft.replace(R.id.content—frame, fragment); 
ft.addToBackStack(null); 

ft.setTransition(FragmentTransaction.TRANSIT—FRAGMENT—FADE); 
ft.commit(); 

//Set the action bar title 

setActionBarTitle (position) ; ^ 七七 ^ bav* i t- 

//Close drawer 

drawerLayout. closeDrawer (drawerList) ; Close the dviwd 


private void setActionBarTitle(int position) { 

String title; |-f usev t\\(Ms oy\ *tV>c option, use *thc aff (or i\\t title- 

if (position == 0){ ^ 

title = getResources().getString(R.string.app—name); 

} else { 

title = titles[position]; 


Mhcv-y/isc ； yt "the S"t\rmg -Pvorw -the "titles av-vay (o\ 
七 he position iha-t was disked av\d use 七 ha 七 


getActionBar () . setTitle (title) ; ^ — pisplay m *tV)C ad*tioir\ bav*. 




l/Ve’ve omiiicd ihc or>Cv*ca-tcOpiio^sMcr>uO ar>d 
/Wair>A^tivily code, as -these 
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open and shut case 


fret the drawer to open awd close 

So far we’ve added a navigation drawer to MainActivity, 
populated it with a list of the major hubs in the app, and got the 
activity to respond when an item is clicked. The next thing we’ll 
look at is how to open and close the drawer, and how to respond 
to its state. 

There are a couple of reasons why you might want to respond 
to the state of the navigation drawer. First, you might want to 
change the title of the action bar when the navigation drawer 
opens and closes. You might, say, want to display the app name 
when the drawer is open, and display the selected fragment when 
the drawer is closed. 

Another reason relates to the action items on the action bar. 

When the drawer is open, you may want to hide some or all of 
these action items so that the user can only click on them when 
the drawer is closed. 

Over the next few pages, we’re going to show you how to set up a 
DrawerListener so that you can listen for Drawer Layout 
events. We’ll use it to hide the share action on the action bar when 
the navigation drawer is open, and make it visible again when the 
drawer closes. 



Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


o 


We know it seems 
like you have to 
take care of a lot 
of things when you 
create a navigation 
drawer. 

Even though the code might seem 
complex, stick with it and you’ll be fine. 



I/Vcll yt "the dv-awc\r 
"to open and dose > — ^ 
usir^g a bu-t-fco^ ov\ 
ihc c 


1 


: 

10:53 1 


% ~ ■ i 




action bd\r. 



Bits And Pizz 

Top fragment 



Settings 


dv-av/cv- is closed, 
display S^3V"C 3£.*bior\ m 
action bar. 



416 


Chapter 10 





















navigation drawers 


□ 


BitsAndPizzas 


Using an ActiowParPrawcrTogglG 

The best way of setting up a DrawerListener is to use an 
Ac tionBarD rawer Toggle. An Ac tionBar Drawer Toggle 
is a special type of DrawerListener that works with an action 
bar. It allows you to listen for Drawer Layout events like a normal 
DrawerListener, and it also lets you open and close the drawer by 
clicking on an icon on the action bar. 

You start by creating two String resources in strings.xml that describe 
the ‘‘open drawer’’ and u close drawer’’ actions. These are needed for 
accessibility: 

<string name= n open_drawer n X)pen drawer</string> 

<string name= n close_drawer M >Close drawer</string 〉 

/\dd these *to 

Then create a new Ac tionBar Drawer Toggle by calling its T^cyVc r\ttAtA -fov 

constructor and passing it four parameters: a Context (usually this /\乙 七 

for the current Context), the Drawer Layout, and the two String 
resources. You then override the Ac tionBar Drawer Toggled 

onDrawerClosed () and onDrawerOpened () methods: Cvcatc "the A^tio^Ba\rD\rav/cv-7ogglc. 

ActionBarDrawerToggle drawerToggle = new ActionBarDrawerToggle(this, drawerLayout, 

R.string.open drawer , R.string.close drawer) { 


L L 3 

app/sre/main 
- . } 


res 


MU 

values 

I_Qj 

\ </% n 

strings.xml 


//Called when a drawer has settled in a completely closed state 
@Override 

public void onDrawerClosed(View view) { 
super.onDrawerClosed(view); 

//Code to run when the drawer is closed 


Tii'is method yts tailed 
七 he dv-a>wcv- is dloscd- 


This rwc-thod yb 匕 ailed when -the dvawev is open. 

//Called when a drawer has settled in a completely open state. 


@Override 

public void onDrawerOpened(View drawerView) 
super.onDrawerOpened(drawerView); 

//Code to run when the drawer is open 


□ 


BitsAndPizzas 


L Q 

app/sre/main 


Once you’ve created the ActionBarDrawerToggle, you 
set it to the DrawerLayout using the Drawer Layout^ 
setDrawerListener () method: 


java 


广 /\dtior>Bav-pvav/Cv"fo^lc 

^ as i\\t Pv-av/cv-LayouVs 

drawerLayout. setDrawerListener (drawerToggle) ; dvav/ev listew 


mi 


com.hfad.bitsandpizzas 

I FoT{j 

Q 

MainActivity.java 
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invalidateOptionsMenuQ 


Modifying action bar items at runtime 

If you have items on your action bar that are specific to the contents of 
a particular fragment, you may want to hide them when the drawer is 
open, and display them again when the drawer is open.When you need 
to modify the contents of the action bar in this way, you have to do two 
things. 

First, you need to call the activity’s invalidateOptionsMenu () 
method. This tells Android that the menu items that need to be on the 
action bar have changed and should be re-created. 

When you call the invalidateOptionsMenu () method, the activity’s 
onPrepareOptionsMenu () method gets called. You can override this 
method to specify how the menu items need to change. 

We’re going to change the visibility of the share action on our action 
bar depending on whether the drawer is open or closed. We therefore 
need to call the invalidateOptionsMenu () method in the 
onDrawerClosed () and onDrawerOpened () methods of the 
ActionBarDrawerToggle: 

public void onDrawerClosed(View view) { 
super.onDrawerClosed(view); 

invalidateOptionsMenu(); 


public void onDrawerOpened(View drawerView) 
super.onDrawerOpened(drawerView); 

invalidateOptionsMenu(); ^ - 


We then use the activity’s onPrepareOptionsMenu () method to set 
the visibility of the share action: 


\/ 

2 

2 


Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


□ 


BitsAndPizzas 


H^jj 

app/sre/main 

-□ 


java 


com.hfad.bitsandpizzas 

13 

MainActivity.java 


t 


tells A^d^ro'id *to rc- 

{p visibility of 从 

i-f dbrav/er is 

opened oV" closed) so v/c td\\ 
oK\Pv-ay/cv-CloscdO methods. 


The OK>P\rcpa\rc0piio^s/l/Ic^u0 
»^C"thod jets ddlled v/hc^cvcv 
iir>valida*tcOp*tio^sMc^uO jets called- 


//Called whenever we call invalidateOptionsMenu() 

@Override 

public boolean onPrepareOptionsMenu(Menu menu) { 

// If the drawer is open, hide action items related to the content view 
boolean drawerOpen = drawerLayout.isDrawerOpen(drawerList); 
menu.findItem(R.id.action share).setVisible(!drawerOpen); 


return super.onPrepareOptionsMenu(menu); 


On the next page, we’ll take you through the full code. 


A ： 

Sc 七七 sv^a\rc attio^s Visibility 
{p ^alsc is 

sc*t i*t *to *tvuc i-f >*b 
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navigation drawers 


The updated MaiwActivity.java code 


Here’s the revised code for MainActivity.java : 


import android.support.v7.app.ActionBarDrawerToggle; 


□ 


BitsAndPizzas 


HD 


public class MainActivity extends Activity 


private ActionBarDrawerToggle drawerToggle; 


/\dtior\Bav-Pva>wcv-"fo^lc app/sre/main 
•is m 

libvav-y. java 


□ 


Set this as B p\riva*tc vaviablc ； 3s we’ll use i*t ’m multiple methods 


Ln 


QOverride 

protected void onCreate(Bundle savedlnstanceState) 


com.hfad.bitsandpizzas 

F«T{j 

ID 

MainActivity.java 


//Create the ActionBarDrawerToggle 

drawerToggle = new ActionBarDrawerToggle(this, drawerLayout, 

R.string.open_drawer, R.string.close 一 drawer) { 

//Called when a drawer has settled in a completely closed state 
public void onDrawerClosed(View view) { 

super.onDrawerClosecKview);^^ 七奉 , s/lW) ▲ 

^ w the dv-a>wcv- is opened or dloscd- 

} ^ 

//Called when a drawer has settled in a completely open state. 
public void onDrawerOpened(View drawerView) { 
super.onDrawerOpened(drawerView); 
invalidateOptionsMenu(); 

} ; } Sel the Dvawc\rLayou^s as -the 

drawerLayout.setDrawerListener(drawerToggle); 


//Called whenever we call invalidateOptionsMenu() 
@Override 

public boolean onPrepareOptionsMenu(Menu menu) { 


Sc*t visibilrb/ of 七 he SKa^rc adW 
dv-av/cv- is opened by\A dosed. 


II If the drawer is open, hide action items related to the content view 


boolean drawerOpen = drawerLayout.isDrawerOpen(drawerList); 
menu.findltem(R.id.action—share)•setVisible(!drawerOpen); 
return super.onPrepareOptionsMenu(menu); 


you are here ► 
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up enabled 


Enable the drawer to open and close 

We’ve added a navigation drawer to MainActivity, populated it 
with a list of options, got the activity to respond when an option is 
clicked, and seen how to hide action items when the drawer is open. 
The final thing we’ll do is let the user open and close the drawer by 
clicking on an icon in the action bar. 

As we said earlier, this functionality is one of the advantages of using 
an Ac tionBar Drawer Toggle. To switch it on, we need to add 
some extra code. We’ll take you through the code changes individually, 
then show you the full MainActivity.java code right at the end. 

First, you enable the icon in the action bar. You do that using these 
two method calls in the activity’s onCreate () method: 

getActionBar().setDisplayHomeAsUpEnabled(true); 
getActionBar().setHomeButtonEnabled(true); 

These lines of code enable the activity’s Up button. As we’re using an 
Ac tionBar Drawer Toggle, the Up button will be used to activate 
the drawer instead of navigating up the app’s hierarchy. 



\/ 

2 

2 


Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


The A^iio^BavD^awcv-Tojglc lets 
you use the bar’s Up 
"to open 如 d dose 七 he dv-a>wcv-. 



Enable Up so you 

dan use vt *? 饮七 ^ drav/cr. 


Next, you need to get the ActionBarDrawerToggle to handle 
being clicked. To do this, you call its onOptionsItemSelected () 
method from within the activity’s onOptionsItemSelected () 
method like this: 


QOverride 

public boolean onOptionsItemSelected(Menultem item) { 


if (drawerToggle.onOptionsItemSelected(item)) 
return true; 


//Code to handle the rest of the action items 


/ou heed -to add these lihes todt io 

method so 

that the A^tiohBa\rPv-av/cv-7ogglc 63r\ 
handle bc'rng 


The code 

drawerToggle. onOptionsItemSelected (item) 


returns true if the ActionBarDrawerToggle has handled being 
clicked. If it returns false, this means that another action item in the 
action bar has been clicked, and the rest of the code in the activity’s 
onOptionsItemSelected () method will run. 


BitsAndPizzas 

L u 

app/sre/main 

L [f 3 

java 



com.hfad.bitsandpizzas 


O 


MainActivity.java 
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Syncing the ActiowParPrawcrToggle state 


There are just two more things we need to do in order to get our 
Ac tionBar Drawer Toggle working properly. 


First, we need to call the Ac tionBar Dr awe rToggle 5 s 
syncState () method from within the activity’s postCreate () 
method. The syncState () method synchronizes the state of the 
drawer icon with the state of the Drawer Layout. 


I/Vcd love \i i-f Mviybcm dv-awev- 
V^a^dlcdi *fo\r you au*to^at^allY) but >*b 
docs^t Vou V^avc -to V^a^dlc \i 


-the siaie that ihe 
dvawcv* i^oh appeav-s ohc way wlieh 
d\rav/c\r is closed, 3hd a^oihe\r 
way wliCh the d\ray/C\r is 


Bits And Pizzas 包 


10:52 


Top fragment 




You need to call the syncState () method in the 
activity’s onPostCreate () method so that the 
ActionBarDrawerToggle is in the right state after the 
activity is created: 



\/ou v\ccd -to add *tWis method -to 
youv Sd'tWi'ty so <yc 

* o^Bav-Prav/' 


@Override 

protected void onPostCreate (Bundle savedlnstanceState) { 

super. onPostCreate (savedlnstanceState) ; ^ — y/rth s*ta*b 

// Sync the toggle state after onRestorelnstanceState has occurred. 
drawerToggle.syncState(); 


t *tV^C 


is m 
dv-av/cv-. 



BitsAndPizzas 


Finally, if the device configuration changes, we need to pass details 
of the configuration change to the ActionBarDrawerToggle. 

We do this by calling the ActionBarDrawerToggle 5 s 
onConf igurationChanged () method from within the 
activity’s onConf igurationChanged () method: 

@Override 

public void onConfigurationChanged(Configuration newConfig) { 
super.onConfigurationChanged(newConfig); 气 



app/sre/main 


java 


Q 

com.hfad.bitsandpizzas 

F«T{| 

Id 

MainActivity.java 


u Y\ttd {o add ihis mcihod 

drawerToggle.onConfigurationChanged(newConfig); ^ ◎欧 


We’ll show you where the latest code changes fit into MainActivity. 
java on the next page, and then we’ll see what happens when we 
run the app. 


to you\r a^tiviiy so 七 ha 七 a^y 

匕 yt passed 

"to -the A^tio^Bav*D\rawc\r7ojglc. 
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MainActivity code 


The updated MaiwActivity.java code 

Here’s the revised code for MainActivity.java : 


\/ 

2 


Add fragments 
Create drawer 
ListView clicks 
ActionBarDrawerToggle 


import android.content.res.Configuration; 

|mpo\rt -this dldss 3s its used by o^Co^-fijuva-tio^Cha^jediO method. 

public class MainActivity extends Activity { 

參參參 

private ActionBarDrawerToggle drawerToggle; 

QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


□ 


BitsAndPizzas 


L Q 

app/sre/main 


java 


com.hfad.bitsandpizzas 

Id 

MainActivity.java 


getActionBar () . setDisplayHomeAsUpEnabled (true) ; 七 he Uf itor\ so 

getActionBar () . setHomeButtonEnabled (true) ; i 七乙 d 灼 be used by 

A^tionBarP^rawc^TojjIc. 


@Override 


protected void onPostCreate(Bundle savedlnstanceState) { 


super.onPostCreate(savedlnstanceState); 
drawerToggle.syncState(); 


"the o-(* "the 

v/iih -the s-ta-tc o-P -the dvawcv. 


@Override 

public void onConfigurationChanged(Configuration newConfig) { 


super.onConfigurationChanged(newConfig); 
drawerToggle.onConfigurationChanged(newConfig); 


pass ar\y -to 

七 k A^t'o^a^rPray/^TojjIc. 


@Override 

public boolean onOptionsItemSelected(Menultem item) 

if (drawerToggle.onOptionsItemSelected(item)) { 

return true; 

} 

//Code to handle the rest of the action items 
switch (item.getltemld()) { 


Lc*t A^tio^Bav-Dv-av/cv-Tojgl 
handle bemj dlidked- 


t 
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K 




Test drive the app 


When we run the app, MainActivity is displayed. It features a 
working navigation drawer: 




Bits And Pizzas 


fop fragment 


you v-u\r\ 

a^t»or\ bav sV^oy/s 
a y\av'i^a*t»or\ dv-av/cv- 
\Cov\- 

o-f is 

disflaycd by dc-fault 
TV^c adtio^ bar displays 
■bV^e aff name. 


10:52 


笆 . 


Bits And Pizzas 


Home 


Pizzas 


Pasta 


Stores 


l/Vhc^ you didk 
OY\ -the r>avigaiioh 
diray/cv- ido 〜七 he 
dvav/cv- operas dhd 
七 he ^avigatio^ 

i 匕 。灼 

lis-t o( options is 

displayed- 


10:54 


笆 . 


10:55 


包 . 


Funghi 


lA/V^eh you c\\cV ov\ -tV^c 
\ pizzas oftioy\) an *ms*tar\^C 
\Jc PiziasFv-ajmc^-b is 
disflaycd, tV^c action bar 
title ^a^cs -to w Pizias” 
ad 如 dv-av/cv- is dosed. 


The Share action item is visible when the drawer is closed, and 
hidden when the drawer is open: 


And Pizzc 



Top fragment 


TVic SV^av-c 

S _ ad*tio\r\ is 

visible i*f *t^c 
dv-awcv- is 
closed- 


There’s just one thing we need to sort out: we need to make sure 
the correct title in the action bar is displayed when the device is 
rotated or the user presses the back button. So what currently 
happens? 



丁 he Sha\rc adtioh is hidden 
_*P the d\ray/c\r is opCh. 


you are here ► 
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more rotation problems 


The title and fragment are getting out of sywc 


When we click on one of the options in the navigation drawer, the 
title in the action bar reflects the fragment that’s displayed. As an 
example, if you click on the Pizzas option, the action bar title gets set 
to “Pizzas ”： 


W\\CY\ you c\\ck OY\ 
y\dv'i^d a bioy\ dv*a>wcv") t>*blc 
yb ufda-ted - ^ 



If you click on the Back button, the title isn’t updated to reflect the 
fragment that’s displayed. As an example, suppose you click on 
the Stores option, followed by the Pizzas option. A list of pizzas is 
displayed and the title reflects this. If you then click on the Back 
button, Stores Fragment is displayed but the title is “Pizzas ”： 


The adtioh ba\f title stays 
the sanr»c whch y/C dlidk Oh the 
Back but-toh. |h this case, it 

wkh a list o-f 
><rcs is displayed 



If you rotate the device, the title reverts to “Bits and Pizzas” 
irrespective of what fragment is displayed: 



TV^c action bar title reset 
^\\ cy \ you v-o*ba*tc *tV^c dcvidc- 


Let’s fix these problems, starting with keeping the action bar title in 
sync when the device is rotated. 
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Pealing with configuration changes 


As you already know，when you rotate your device, the current activity 
gets destroyed and re-created. This means that any user interface 
changes you have made are lost, including changes to the action bar title. 

Just as we did in earlier chapters, we’ll use the activity’s 
onSavelnstanceState () method to save the position of the 
currently selected item in the navigation drawer. We can then use this in 
the onCreate () method to update the title in the action bar. 

Here are the code changes: 


public class MainActivity extends Activity 


private int currentPosition = 0; 

Sc*t duvvcir>*tPos*itioir> *to O by de-fault 

QOverride 

protected void onCreate(Bundle savedlnstanceState) 


□ 

Bits And Pizzas 

L Q 

app/sre/main 


java 



com.hfad.bitsandpizzas 

F*«il 


ID 

MainActivity.java 


//Display the correct fragment, 
if (savedlnstanceState != null) { 

currentPosition = savedlnstanceState.getlnt("position"); 

setActionBarTitle (currentPosition) ; the adiviiy has bee, dest.o 

} else { 1 

selectltem(O); 

> A 



display TifFVa ， ⑼七 . 


Ad sci the value 

^u\r\rCh-tPosi-tioh -p\rorw the ad-tivity 

J^vious state 釙 d use it "to s^t 

adtioh ba\r title. 


s 


private void selectltem(int position) { 

currentPosition = position; ^ Update dum.tPosilio, whe, a, iler, is selc^cd- 


@Override 

public void onSavelnstanceState(Bundle outState) { 
super.onSavelnstanceState(outState); 
outState.putlnt("position", currentPosition); 

} ^ 

Save *tV>c s*ta*tc duvvwtPosrtion I*f 

*to be dcs*tv*oycd- 


you are here ► 
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listen to the back stack 


Reacting to changes on the back stack 


The final thing we need to address is how to make the action bar 
title reflect the fragment that’s displayed when the user clicks on 
the back button. We can do this by adding a FragmentManager. 
OnBackStackChangedListener to the activity’s fragment 
manager. 

TheFragmentManager.OnBackStackChangedListener 
interface listens for changes to the back stack. This includes when a 
fragment transaction is added to the back stack, and when the user 
clicks on the back button to navigate to a previous back stack entry. 

You add an OnBackStackChangedListener to the activity’s 
fragment manager like this: 


□ 


BitsAndPizzas 


app/sre/main 


java 


一 I 


com.hfad.bitsandpizzas 

FoT{| 

a 

MainActivity.java 


getFragmentManager().addOnBackStackChangedListener( 


new FragmentManager.OnBackStackChangedListener() { 


public void onBackStackChanged() { 


//Code to run when the back stack changes 


When the back stack changes, the 

OnBackStackChangedListener^ onBackStackChanged () 
method gets called. Any code you want to run when the user clicks 
on the back button should be added to this method. 


You add a ^ 

〜 BatkSlatkC—edUsWn 

i*b o^BadkS*tadkCV>a^cdO 
TW»s method is tailed 
badk stad 


When the onBackStackChanged () method gets called, we want 
to do three things. 

o Update the cur rent Posit ion variable so that it reflects the position 
in the list view of the currently displayed fragment. 

o Gall the setActionBarTitle () method, passing it the value of 


currentPosition. 



Make sure that the right option in the navigation drawer’s list view is 
highlighted by calling its set I temChecked () method. 


Each of these depends on us knowing the position in the list view of 
the currently displayed fragment. So how do we work this out? 
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Adding tags to fragments 

To work out what the value of cur rent Posit ion should be, 
we’ll check what type of fragment is currently attached to the 
activity. As an example, if the attached fragment is an instance of 
PizzaFragment, we’ll set currentPosition to 1. 

We’ll get a reference to the currently attached fragment by adding a 
String tag to each fragment. We’ll then use the fragment manager’s 
f indFragmentByTag () method to retrieve the fragment. 

You add a tag to a fragment as part of a fragment transaction. Here’s 
the current fragment transaction we’re using in our selectltem () 
method to replace the fragment that’s currently displayed: 

FragmentTransaction ft = getFragmentManager().beginTransaction(); 
ft.replace(R.id.content—frame, fragment); 
ft.addToBackStack(null); 

ft.setTransition(FragmentTransaction.TRANSIT 一 FRAGMENT 一 FADE)/ 
ft.commit(); 


□ 


BitsAndPizzas 


app/sre/main 

圓〜 ~| 


java 



com.hfad.bitsandpizzas 

a 

MainActivity.java 


To add a tag to the fragment, you add an extra String parameter to 
the replace () method in the transaction: 

FragmentTransaction ft = getFragmentManager().beginTransaction(); 
ft. replace (R. id. content_f rame , fragment, "visible 一 fragment'▼) 
ft.addToBackStack(null); 

ft.setTransition(FragmentTransaction.TRANSIT—FRAGMENT 一 FADE); 
ft.commit(); 

In the above code, we’re adding a tag of n visible_f ragment n 
to the replace () method. Every fragment that’s displayed in 
MainActivity will be tagged with this value. 

Next, we’ll use the fragment manager’s f indFragmentByTag () 
method to get a reference to the currently attached fragment. 


This adds a ia^ of 

Visible_JVa ， ⑶ t” "to 

"the Ss i^s 

sdded -fco -the ba 匕 k 

s-bdk. 


you are here ► 
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playing tag 


Find the fragment using its tag 


To retrieve the fragment that’s currently attached to the activity, 
we’ll pass the tag we set as part of the fragment transaction to the 
f indFragmentByTag () method: 

FragmentManager fragMan = getFragmentManager(); 





Fragment fragment = fragMan.findFragmentByTag("visible fragment"); 


The f indFragmentByTag () method starts by searching all fragments 
that are currently attached to the activity. If it can find no fragment with 
the correct tag, it then searches through all fragments on the back stack. 
By giving all fragments the same tag of n visible_f ragment", the 
above code will get a reference to the fragment that’s currently attached to 
the activity. 


Here’s the full code for the OnBackStackListener. We’re using the 
f indFragmentByTag () method to get a reference to the currently 
attached fragment. We’re then checking which type of fragment it’s an 
instance of so we can work out the value of cur rent Posit ion: 


getFragmentManager().addOnBackStackChangedListener( 

new FragmentManager.OnBackStackChangedListener() { 

public void onBackStackChanged() { 

FragmentManager fragMan = getFragmentManager(); 


This gets the 
^u\r\TCh-tly attached h> 
the adtivi-ty. 


Fragment fragment = fragMan.findFragmentByTag("visible fragment"); 


if (fragment instanceof TopFragment) 
currentPosition = 0; 


^ - wV^a-t type o-f it 



if (fragment instanceof PizzaFragment) { 
currentPosition = 1; 

} 

if (fragment instanceof PastaFragment) { 
currentPosition = 2; 

} 

if (fragment instanceof StoresFragment) { 
currentPosition = 3; 



BitsAndPizzas 

L Q 

app/sre/main 



setActionBarTitle(currentPosition); 

drawerList.setltemChecked(currentPosition , true) 


com.hfad.bitsandpizzas 

Id 

MainActivity.java 


Sci ihc bav- 七 rtle and highlijhi ihc 
CoYYtd i-tem \v\ 七 he dvawcv- Lisi\/icv/. 


That’s all the code we need to get our action bar titles to sync with the 
displayed fragment when the user clicks on the Back button. Before we see 
it running, let’s look at the full code for MainActivity.java. 
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The full MaiwActivity.java code 

Here’s the entire code for MainActivity.java : 


package com.hfad.bitsandpizzas; 


WicVc usrnj *tV)C 

fVa ， ⑼七 tlass, so 

we y\ttd *to imfovt it 


_I 


BitsAndPizzas 


import android.app.Activity; 
import android.app.Fragment; 

import android.app.FragmentManager; 

import android.app.FragmentTransaction; 
import android•content • 工 ntent; 
import android.content.res.Configuration; 
import android.os.Bundle; 

import android.support.v7.app.ActionBarDrawerToggle; 


L Q 

app/sre/main 


java 


□ 


com.hfad.bitsandpizzas 

F»T{| 

P 

MainActivity.java 






import android.view.Menu; 
import android•view•Menultem; 
import android.view.View; 
import android.widget.AdapterView; 
import android.widget.ArrayAdapter; 
import android.widget.ListView; 
import android.widget.ShareActionProvider; 
import android.support.v4.widget.DrawerLayout; 


TKcsc art all classes used m i\\t cod^ 


public class MainActivity extends Activity { 



private ShareActionProvider ShareActionProvider; 
private String[] titles; 
private ListView drawerList; 
private DrawerLayout drawerLayout; 
private ActionBarDrawerToggle drawerToggle; 
private int currentPosition = 0; 


^ us 3 all these f\riva-tc variables. 




TKc O^I-tcmClidkLis-tc^c^s ov>|*tcmCI*idkO 
meiKod yb called ⑼七 he usev t\\tVs 
oy\ aY\ 1 -tcm *m i\\t Ara^itrs L*is*t\/*icy/. 


private class DrawerltemClickListener implements ListView•OnltemClickListener { 
QOverride 

public void onltemClick(AdapterView<?> parent. View view, int position, long id) 
//Code to run when an item in the navigation drawer gets clicked 
selectltem(position); 


Call -the scIcdtltcmO method when a 竹 
i 七 Cm m 七 he d\rawc\r Listl/icw is dlidked- 


T\\t Code dor\tmiACS 

or\ paje. 
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MaiwActivity.java (cowti 剛 d) □ 

BitsAndPizzas 


@Override 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 


l L 3 

app/src/main 


setContentView(R.layout.activity_main); 

titles = getResources().getStringArray(R.array.titles); 
drawerList = (ListView)findViewByld(R•id•drawer); 
drawerLayout = (DrawerLayout) findViewByld(R•id•drawer—layout); 
//Initialize the ListView 


java 




com.hfad.bitsandpizzas 

I 山 " 

ID 

MainActivity.java 


drawerList.setAdapter(new ArrayAdapter<String>(this, 

android.R.layout.simple_list_item_activated_l , titles)); 
drawerList•setOnltemClickListener(new DrawerltemClickListener()); 

//Display the correct fragment. 


Populate 


By\A *to 
vespond bo dl'idks. 


if (savedlnstanceState != null) { 

currentPosition = savedlnstanceState.getlnt("position"); 

setActionBarTitle (currentPosition) ; ^ ihc adtivi^s be ⑶ desivoyed a^d vc- 

} else { Sealed, sci ihc CoYYtd ba^ 七 iile. 

selectltem(O) ; 七 

by dc-rault 


// Create the ActionBarDrawerToggle 


drawerToggle = new ActionBarDrawerToggle(this, drawerLayout A 
R•string•open—drawer, R.string.close_drawer) { 


// Called when a drawer has settled in a completely closed state 
QOverride 



public void onDrawerClosed(View view) { 


super.onDrawerClosed(view); 


invalidateOptionsMenu(); 



Call mvalidatcOftio^sMcr>u ⑼七 he dv-a>wcv* is 
o^tr\ or dlosed bcdausc >wc v/3ir>*t *to 七 V>c 

ad*tioy^ itch's displayed 七 he bav*. 


// Called when a drawer has settled in a completely open state. 


@Override 


public void onDrawerOpened(View drawerView) { 
super.onDrawerOpened(drawerView); 
invalidateOptionsMenu(); 


TV^C Code dor\tmuCS 

OY\ 
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navigation drawers 


MaiwActivity.java (contmued) 


TV^'is code is still fav-t i\\t o^Cv-catcO method. 


drawerLayout.setDrawerListener(drawerToggle); 
getActionBar().setDisplayHomeAsUpEnabled(true); 

getActionBar () . setHomeButtonEnabled (true) ; Enable "the Up i^oh oh the 3 匕 tioh bav- 

so wc 6^v\ use it "to opCh the dv^dy/ev. 

getFragmentManager().addOnBackStackChangedListener( 

new FragmentManager.OnBackStackChangedListener() { 


This yb dalled 
v/V>cir> badk 
s*tadk 


^ pioblic void onBackStackChanged () { 


CKcdk y/kidk dlass 
"the 

6u\r\rchtly at-bdhcd 

■to the activity is 
如 ihs-bhdc o(, ahd 

set duv-v-ChtPosi-tioh 
ad^o\rdihg!y. 



FragmentManager fragMan = getFragmentManager(); 

Fragment fragment = fragMan.findFragmentByTag(，▼ visible 一 fragment n ); 
if (fragment instanceof TopFragment) { 

currentPosition = 0; |-^ — | 

BitsAndPizzas 

L a 

app/sre/main 

L Q 

java 


(fragment instanceof PizzaFragment) 
currentPosition = 1; 



^if (fragment instanceof PastaFragment) 
currentPosition = 2; 


if (fragment instanceof StoresFragment) 
currentPosition = 3; 


com.hfad.bitsandpizzas 

O 

MainActivity.java 


setActionBarTitle(currentPosition); 

drawerList.setltemChecked(currentPosition, true) 

Se 七七 he athoY\ bav title a^d KijKl'ijKt tKc 
dov*V"Cd*t dv* 3 v/cv L-is*b\/ic>/* 


TV^c Code terntmues ’ — ^ 
oy \ *tV^c 


you are here ► 
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more MainActivity code 


MaiwActivity.java (contmued) 


lAfe tall method ^ usev 

dkks 咖 ahtem m d^ra^s List\/’ 》 cy/. 

private void selectltem(int position) { 

// update the main content by replacing fragments 

currentPosition = position; 

Fragment fragment; 
switch(position) { 


r*v 



Bits And Pizzas 


HU 

app/sre/main 

'-Z 3 


java 


new PizzaFragment() 


case 丄： 

fragment 
break; 
case 2 : 

fragment 
break; 
case 3 : 

fragment = new StoresFragment(); 
break; 



new PastaFragment() 



com.hfad.bitsandpizzas 

p. 

MainActivity.java 


Decide wkidh "fco display 

based oh the positioh o-p the item the 
use\r selects ih the d\rawc\r ； s Lis-tl/icw. 


default : 

fragment = new TopFragment () ; ^Disylay the •fva^iwen't- 

FragmentTransaction ft = getFragmentManager().beginTransaction() 
ft•replace(R.id.content—frame, fragment, "visible 一 fragment ”）； 
ft.addToBackStack(null); 

ft.setTransition(FragmentTransaction.TRANSIT—FRAGMENT 一 FADE); 
ft.commit(); 

//Set the action bar title 

setActionBarTitle(position); D |s play 七 he \rijhi -ti-tlc *m ihc ad:ion bar. 

//Close the drawer 

drawerLayout.closeDrawer(drawerList); 

Close *thc dv-a>wcv-. 
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navigation drawers 


MaiwActivity.java (cowti 剛 d) 

QOverride 

public boolean onPrepareOptionsMenu(Menu menu) { 

// If the drawer is open, hide action items related to the content view 
boolean drawerOpen = drawerLayout.isDrawerOpen(drawerList); 
menu.findltem(R.id.action_share).setVisible(!drawerOpen); 

return super. onPrepareOptionsMenu (menu); 欠 pi—ay 七 he Sha\rC athoy\ i-P i\\t drawee is 
} closed, hide i-f dv-av/cv- is 

@Override 

protected void onPostCreate(Bundle savedlnstanceState) { 
super.onPostCreate(savedlnstanceState); 

// Sync the toggle state after onRestorelnstanceState has occurred. 

drawerToggle. syncState 0 ； Syw 七 he stale o( ihc A^io^Ba^Dv-av/cv-To^glc 
} wi 七 h 七 he siaic o( 七 he dv-awcv-. 


QOverride 

public void onConfigurationChanged(Configuration newConfig) 
super.onConfigurationChanged(newConfig); 
drawerToggle.onConfigurationChanged(newConfig); 

} pass dcbdiU o( 

-to -the A^o^Bav-Pvav/cv-To^lc. 

@Override 

public void onSavelnstanceState(Bundle outState) { 
super.onSaveInstanceState(outState); 
outState.putlnt("position", currentPosition); 

} 


□ 

BitsAndPizzas 

LQ 

app/sre/main 

L a 


^ Save the o( duv-v-c^Posi-tio^ i-f -the adtivi-ty^s des-tv-oyed- 


private void setActionBarTitle(int position) { 

String title; 
if (position == 0){ 

title = getResources().getString(R.string.app_name); 

} else { 

title = titles[position]; 

} Sc*t *tKc bav title so *i*t 

getActionBar () . setTitle (title) ; ^ 一 . vc-Plcd*ts *tKc *tKaVs 

} displayed. 


java 


com.hfad.bitsandpizzas 

山 “ F*«{l 


ID 

MainActivity.java 


T\\t Codt tor\tmuCS ^~^ 

OY\ 阿 . 
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nearly there 


MaiwActivity.java (cowti 剛 d) 

QOverride 

public boolean onCreateOptionsMenu(Menu menu) 


/\aa items m 

-f lic -to *tV)C a^tioy\ bav-. 


// Inflate the menu; this adds items to the action bar if it is present. 


getMenuInflater().inflate(R.menu.menu_main f menu); 

Menultem menultem = menu•findltem(R.id•action_share); 

shareActionProvider = (ShareActionProvider) menultem•getActionProvider(); 


setlntent (’'This is example text"); 


return super.onCreateOptionsMenu(menu); 


Pass 七 |^ Shave dd'biort -Po\r i*t "to shave- 

private void setlntent(String text) { 

Intent intent = new Intent ( 工 ntent•ACTION 一 SEND); 
intent.setType("text/plain"); 
intent•putExtra ( 工 ntent•EXTRA—TEXT, text); 
shareActionProvider.setShareIntent(intent); 


@Override 




This method is ddlled y/h ⑼七 he usev 
c]\tks OY\ av\ rtem *m ad*t*ioir> bar. 


public boolean onOptionsItemSelected(Menultem item) 


□ 

BitsAndPizzas 

app/sre/main 

L D 


java 


□ 


com.hfad.bitsandpizzas 

p. 

MainActivity.java 


if (drawerToggle•onOptionsItemSelected(item)) { 

return true; ^ K is didked, \ci \i handle M happen 


s. 


switch (item.getltemld()) { 

case R.id.action_create_order : 

//Code to run when the Create Order item is clicked 
工 ntent intent = new 工 ntent(this, OrderActivity.class); 
startActivity (intent) ; Ordtr ad*t*ior> is 

return true; disked, siari 

case R.id.action_settings : 

//Code to run when the settings item is clicked 
return true; 
default : 

return super•onOptionsItemSelected(item); 
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navigation drawers 



Test drive the app 


Let’s see what happens when we run the app. 


11:10 


Spaghetti Bolognese 


Lasagne 



you e\\ck or\ i\\t Pasia 
option, PastaFVa，dis 
disflayed Br\d ad*t*ioir> bav 
*t*i*tlc is *to w Pas*t3 - 



When you click on the back button, the previously selected 
fragment is displayed and the action bar title stays in sync. The 
action bar title also stays in sync when you rotate the device. 


11:12 



you are here ► 
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toolbox 



You’ve got Chapter 10 under 
your belt and now you’ve 
added drawer layouts to your 


Your Android Toolbox 


You c^y\ download 
-full code ^OV 


wt 七尸 : //Uy 价 

HcadPtv-stA^dvoid. 


toolbox 



BULLET POINTS 


■ Use a DrawerLayout to create an activity with a navigation 
drawer. Use the drawer to navigate to the major hubs of your app. 

■ If you're using an action bar, use Ac tionBar Drawer Toggle 
as a DrawerListener. This allows you to respond to the 
drawer opening and closing, and adds an icon to the action bar for 
opening and closing the drawer. 

■ To change action bar items at runtime, call 

invalidateOptionsMenu () and add the changes in the 
activity's onPrepareOptionsMenu () method. 

■ React to changes on the back stack by 
implementing the FragmentManager. 
OnBackStackChangedListener(). 

■ The fragment manager’s f indFragmentByTag ( ) method 
searches for fragments with a given tag. 
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11 S^Lite dqtal^cises 


I Fire Up the Database ♦ 



If you’re recording high scores or saving tweets, your app will 

need to store data. And on Android you usually keep your data safe inside a 
SQLite database. In this chapter, well show you how to create a database, add tables 
to it, and prepopulate it with data, all with the help of the friendly SQLite helper. You’ll 
then see how you can cleanly roll out upgrades to your database structure, and how to 
downgrade it if you need to pull any changes. 


this is a new chapter 
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Starbuzz again 


Pack to Starbuzz 

Back in Chapter 6, we created an app for Starbuzz. The app 
allows users to navigate through a series of screens so that 
they can see the drinks available at Starbuzz. 


10:26 


奮 Coffee 


Drinks 


Food 


Stores 


TKc *fcof-lcvcl 

displays a 

o( options. 



10:47 


ov\ the 

D\rmks option shows 
you d lis-t o( -the 

available dv-'mks. 


Latte 

A couple of espresso shots with steamed milk 



W\\tY\ you dlitk 
a dv-*mk, i*ts details 
av-c displayed- 


The Starbuzz database gets its drink data from a Drink class 
containing a selection of drinks available at Starbuzz. While 
this made building the first version of the app easier, there’s a 
better way of storing and persisting data. 


Over the next two chapters, we’re going to change the 
Starbuzz database so that it gets its data from a SQLite 
database. In this chapter, we’ll see how to create the database, 
and in the next chapter, we’ll show you how to connect 
activities to it. 
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SQLite databases 


Android uses SQLite databases to persist data 


All apps need to store data, and the main way you do that in Androidville 
is with a SQLite database. Why SQLite? 





Its lightweight. 

Most database systems need a special database server process 
in order to work. SQLite doesn’t, a SQLite database is just a 
file. When you’re not using the database, it doesn’t use up any 
processor time. That’s important on a mobile device, because 
we don’t want to drain the battery. 


Its optimized for a single user. 

Our app is the only thing that will talk to the database, so 
we shouldn’t have to identify ourselves with a username and 
password. 

Its stable and fast. 

SQLite databases are amazingly stable. They can handle 
database transactions, which means if you’re updating several 
pieces of data and screw up, SQLite can roll the data back. 
Also, the code that reads and writes the data is written in 
optimized G code. Not only is it fast, but it also reduces the 
amount of processor power it needs. 


We’re going to go 
tkrougk tke basics ol 
SQLite in tkis ckapter. 


H you plan on doingf a 
lot ol database kea 



lifting in your apps, we 
suggest you do more 
background reading on 

SQLite and SQL* 


Whcrfs the database stored? 


Android automatically creates a folder for each app where the app’s 
database can be stored. When we create a database for the Starbuzz app, 


it will be stored in the following folder: 




/ data/data/com. hfad. starbuzz/databases 



An app can store several databases in this folder. Each database 
consists of two files. 

The first file is the database file and has the same name 
as your database — for example, “starbuzz”. This is the main 
SQLite database file. All of your data is stored in this file. 

The second file is the journal file. It has the same name 
as your database, with a suffix of “-journal” 一 for example, 
“starbuzz-journal”. The journal file contains all of the changes 
made to your database. If there’s a problem, Android will use 
the journal to undo (or rollback) your latest changes. 




u. 


data 

L 


3 

L 


□ 


com. hfad. starbuzz 


HI] 

databases 


This is 七 he database -file- —^ 


TiVis is 七 lie jouv^al -f ile- ^ 


儀 


starbuzz 


L I1 


starbuzz-journal 
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your new best friends 


Android comes with SQLite classes 

Android uses a set of classes that allows you to manage a 
SQLite database. There are three types of object that do the 
bulk of this work. 


The SQLite Helper 

You create a SQLite 
helper by extending the 
SQLiteOpenHelper 
class. This enables you 
to create and manage 
databases. 



Cursors 


A Cursor lets you 
read from and write to 


the database. It’s like a 


ResultSet in JDBC. 


We’re going to use these objects to show you how to create a 
SQLite database your app can use to persist data by replacing 
the Drink class with a SOLite database. 



The SQLite database 

The SQLiteDatabase 
class gives you access to 
the database. It’s like a 
SQLConnection in JDBC. 


If there's no username and 
password on the database, how is it 
kept secure? 

The directory where an app’s 
databases are stored is only readable by 
the app itself. The database is secured 
down at the operating system level. 

Can I write an Android app that 
talks to some other kind of external 
database, such as Oracle? 



There’s no reason why you can’t 
access other databases over a network 
connection, but be careful to conserve 
the resources used by Android. For 
example, you might use less battery power 
if you access your database via a web 
service. That way, if you’re not talking to 
the database, you're not using up any 
resources. 

Why doesn’t Android use JDBC to 
access SQLite databases? 


We know we're going to be using a 
SQLite database, so using JDBC would be 
overkill. Those layers of database drivers 
that make JDBC so flexible would just drain 
the battery on an Android device. 

Is the database directory inside 
the app’s directory? 

No. It's kept in a separate directory 
from the app’s code. That way, the app can 
be overwritten with a newer version, but 
the data in the database will be kept safe. 
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SQLite databases 


The current Starbuzz app structure 

Here’s a reminder of the current structure of the Starbuzz app: 


o 

❺ 


TopLevelActivity contains a list of options for 
Drinks, Food, and Stores. 

When the user clicks on the Drinks option, it 
launches DrinkCategoryActivity. 

This activity displays a list of drinks that it gets from the 
Java Drink class. 


❺ 


Device 


When the user clicks on a drink, its details get 
displayed in DrinkActivity. 

DrinkActivity gets details of the drink from the Java 
Drink class. 


The aff duvvcir>*tly *i*b 
dd'td -fv^orn Pv*nr>k dldSS. 





activity—top—level.xml 


Drink.java 


activity—drink.xml 



TopLevel Activity .java 


DrinkCategoryActivity.java 


DrinkActivity.java 


How does the app structure need to change if we’re to use a 
SQLite database? 




Da this! 


We’re going to update the 
Starbuzz app in this chapter ， 
so open your original Starbuzz 
project in Android Studio. 


you are here ► 
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change app 


Well change the app to use a database 

We’ll use a SQLite helper to create a SQLite database we can use with 
our Starbuzz app. We’re going to replace our Drink Java class with a 
database, so we need our SQLite helper to do the following: 



Create the database. 

Before we can do anything else, we need to get the SQLite helper to create 
version 1 (the first version) of our Starbuzz database. 



Create the Drink table and populate it with drinks. 

Once we have a database, we can create a table in it. The table structure 
needs to reflect the attributes in the current Drink class, so it needs to be 
able to store the name, description, and image resource ID of each drink. 
We’ll then add three drinks to it. 


The app has the same structure as before except that we’re replacing 
the file Drink.jam with a SQLite helper and a SQLite Starbuzz 
database. The SQLite helper will maintain the Starbuzz database, and 
provide access to it for the other activities. We’ll change the activities 
to use the database in the next chapter. 




Wig’ll s*fcovc dhrmks m d 
database v-a*tKcv -the 
Pv-mk tlass. 


Device 



activity—top—level.xml 


TopLevel Activity .java 


Let’s start by looking at the SQLite helper. 



Starbuzz 

database 



SQLite Helper 


activity—drink.xml 



DrinkCategoryActivity.java 



DrinkActivity.java 


I 灼 -the 匕 hap 七饮， v/cll 

七 he ad-tivi-tics iha-t access -the Dvmk 

dlass so "thd 七 "they use "the 
msiead. 
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The SQLite helper manages your database 

The SQLiteOpenHelper class is there to help you create 
and maintain your SQLite databases. Think of it as a personal 
assistant who’s there to take care of the general database 
housekeeping. 

Let’s look at some typical tasks that the SQLite helper can assist 
you with: 



SQLite databases 

Create database 
Create table 


Creating the 
database 


When you first install 
an app, the database file 
won’t exist. The SQLite 
helper will make sure the 
database file is created 
with the correct name 
and with the correct table 
structures installed. 



The SQLite helper 


Keeping the database shipshape 


Getting access to 
the database 

Our app shouldn’t 
need to know all of the 
details about where 
the database file is, so 
the SQLite helper can 
serve us with an easy- 
to-use database object 
whenever we need it. At 
all hours, day or night. 


The structure of the database will probably 
change over time, and the SQLite helper can 
be relied upon to convert an old version of a 
database into a shiny, spiffy new version, with 
all the latest database structures it needs. 
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create helper 

Create the SQLite helper 

You create a SQLite helper by writing a class that extends the 
SQL! teOpenHelper class. When you do this, you must override 
the onCreate () and onUpgrade () methods. These methods are 
mandatory. 

The onCreate () method gets called when the database first gets 
created on the device. The method should include all the code 
needed to create the tables you need for your app. 

The onUpgrade () method gets called when the database needs to 
be upgraded. As an example, if you need to make table changes to 
your database after it’s been released, this is the method to do it in. 

In our app, we’re going to use a SQLite helper called 
StarbuzzDatabaseHelper. Create this class in your Starbuzz 
project by highlighting the app/sre/main/java/com. hfad. starbuzz folder 
in your project folder explorer, and navigating to File—>New".—Java 
Glass. Give the class a name of “StarbuzzDatabaseHelper”，then 
replace its contents with the code below: 

package com.hfad.starbuzz; 



Create database 
Create table 


java.Iang.Object 


△ 


android.database.sqlite. 

SQLiteOpenHelper 

onCreate(SQLiteDatabase) 

onUpgrade(SQLiteDatabase, int, int) 

onDowngrade(SQLiteDatabase, int, int) 

onOpen(SQLiteDatabase) 

getReadableDatabaseO 

getWritableDatabaseO 


T 

v* dlass is a 


The 

subclass o-P Object 



import android. database. sqlite . SQLiteOpenHelper; i^clpcv-s mus 七 

import android. content • Context; 七 ^ 

import android.database.sqlite.SQLiteDatabase; / □ 

Starbuzz 

L Q 

app/sre/main 

□ 

java 


class StarbuzzDatabaseHelper extends SQLiteOpenHelper 


StarbuzzDatabaseHelper(Context context) { 



@Override .. 

com. hfad. starbuzz 

public void onCreate(SQLiteDatabase db) { |_ 

} The a,d oM^dcO ^ihods av-c 

StarbuzzDatabase 
Helper.java 


@Override 


啪扣 da^tovy. Ic-Pi ihem erwpiy -Pov- y\o>n, av\d well 

look a 七 -them \y\ rwo\rc detail ihiroughoui the dhapiev-. 


public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


To get the SQLite helper to do something, we need to add code to its 
methods. The first thing to do is tell the SQLite helper what database 
it needs to create. 
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SQLite databases 


1. Specify the database 


There are two pieces of information the SQLite helper needs in 
order to create the database. 


First, we need to give the database a name. By giving the database 
a name, we make sure that the database remains on the device 
when it’s closed. If we don’t，the database will only be created in 
memory, so once the database is closed, it will disappear. 

The second piece of information we need to provide is the version 
of the database. The database version needs to be an integer 
value, starting at 1. The SQLite helper uses this version number to 
determine whether the database needs to be upgraded. 


Cv-catm^ databases avc o^ly 
^ kid m memovy be ^sc-ful 一⑼ 
youVc -testmj youv- aff- 


You specify the database name and version by passing them to the 
constructor of the SQLiteOpenHelper superclass. We’re going 
to give our database a name of “starbuzz”，and as it’s the first 
version of the database, we’ll give it a version number of 1. Here’s 
the code we need (update your version of Starbuzz^atabaseHelper. 
jam with the code below): 


Name ：、、 starbuzz 〃 
Version ： 1 


SQLite database 


class StarbuzzDatabaseHelper extends SQLiteOpenHelper { 


private static final 
private static final 


String DB_NAME = "starbuzz"; // the name of our database 
int DB VERSION =1; // the version of the database 


StarbuzzDatabaseHelper(Context context) { 1/VleVc doy>s*tvud*tov *tKc 

super (context, DB_NAME, null, DB_VERSION) ; sufCV-dlass, passing 

} 一个一 •• 七七 k database Y\a^t ad vc\rs*ior>. 

This is ah -PcaW v-clatmg -to 


〜\rso\rs. \NtYt du\rsov-s m the hex 七乩外七饮. 


□ 


Starbuzz 


The constructor specifies details of the database, but the database 
doesn’t get created at that point. The SQLite helper waits until the 
app needs to access the database, and the database gets created at 
that point. 


L Q 

app/sre/main 



Once you’ve told the SQLite helper what database to create, you 
can specify its tables. 


com. hfad. starbuzz 


F«I{| 

a 


StarbuzzDatabase 

Helper.java 
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tables 

Inside a SQLite database 


iVe'e Aoy\c wc need "to yt 

"the dd'tdbdse when we v\ttd it 



v/ 


Create database 
Create table 


The data inside a SQLite database is stored in tables. A table contains 
several rows, and each row is split into columns. A column contains a single 
piece of data, like a number of a piece of text. 


You need to create a table for each distinct piece of data that you want to 
record. In the Starbuzz app, for example, we’ll need to create a table for the 
drink data. It will look something like this: 


Ti^c dolumir>s m 'toiblc 3v*c 

jd t NAME, PKCRIPTION, a^A 
TMA^MKOURCEJP- TKe 

prmk dlass doy>*ta*mcd similarly 
earned a*t*tv'ibu*tcs. 


\f 


id 

NAME 

DESCRIPTION 

IMA6E RES0URCE ID 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 

2 

“Cappuccino” 

"Espresso, hot milk and 

654334453 



steamed-milk foam" 


3 

“Filter” 

"Our best drip coffee" 

443S4S34 


Some columns can be specified as primary keys. A primary key uniquely 
identifies a single row. If you say that a column is a primary key, then the 
database won’t allow you to store rows with duplicate keys. 

We recommend that your tables have a single integer primary key column 
called _id. This is because Android code is hardwired to expect a numeric 
—id column, so not having one can cause you problems later on. 

Storage classes and data-types 

Each column in a table is designed to store a particular type of data. For 
example, in our DRINK table, the DESCRIPTION column will only ever 
store text data. Here are the main data types you can use in SQLite, and 
what they can store: 


INTEGER 

Any integer type 

TEXT 

Any character type 

REAL 

Any floating-point number 

NUMERIC 

Booleans, dates, and date-times 

BLOB 

Binary Large Object 


Unlike most database systems, you don’t need to specify the column size in 
SQLite. Under the hood, the data type is translated into a much broader 
storage class. This means you can say very generally what kind of data 
you’re going to store, but you’re not forced to be specific about the size of 
data. 


It’S an Anctroid 
convention to call 


your primary key 
columns 」 ct. Anctroid 
cocte expects tkere to 
te an id column on 


your data. Ignoring 
tkis convention will 
make it karcter to get 
tke data out oi your 
database anct into 
your user interface. 
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SQLite databases 


You create tables using Structured Query Language (SQL) 


Every application that talks to SQLite needs to use a standard database 
language called Structured Query Language. SQL is used by almost every 
type of database. If you want to create the DRINK table, you will need to 
do it in SOL. 


This is the SQL command to create the table: 」d is pv*imav-y key- 


CREATE TABLE DRINK 

The -table ir>arwC —^ 




[一 id INTEGER PRIMARY KEY AUTO INCREMENT, 
NAME TEXT, 

These the table / description text, 

IMAGE RESOURCE ID INTEGER) 



The CREATE TABLE command says what columns you want in the table, 
and what the data type is of each column. The _id column is the primary 
key of the table, and the special keyword AUTOINGREMENT means that 
when we store a new row in the table, SQLite will automatically generate a 
unique integer for it. 


The onCreateO method is called when the database is created 

The SQLite helper is in charge of creating the SQLite database the first 
time it needs to be used. First, an empty database is created on the device, 
and then the SQLite helper onCreate () method is called. 

The onCreate () method is passed a SQLiteDatabase object as a 
parameter. We can use this to run our SQL command with the method: 

SQLiteDatabase. execSQL (String sql) ; ^ — "the £^L m i\\t 

oy \ d3"tcib3sc- 

This method has one parameter, the SQL you want to execute. 

Here’s the full code for the onCreate () method: 


Tke 

SQLiteDatatase 


class gives you 


access to tke 
database. 


QOverride 

public void onCreate(SQLiteDatabase db){ 

db. execSQL ("CREATE TABLE DRINK (，▼ 

+ ，▼一 id INTEGER PRIMARY KEY AUTO INCREMENT, 
+ "NAME TEXT, n 
+ "DESCRIPTION TEXT, ，▼ 

+ "IMAGE 一 RESOURCE 一 ID INTEGER) ;，▼); 

} 

This gives us an empty DRINK table, but what if we want to prepopulate 
it with data? 


H 


□ 

Starbuzz 

413 

app/sre/main 

L D 

java 


□ 
com.hfad.starbuzz 

O 

StarbuzzDatabase 

Helper.java 
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insertf) 

Iwscrt data using the msertO method 


V ： 


Create database 
Create table 


The SQLiteDatabase class contains several methods that enable you to insert, 
update, and delete data. We’ll look at these methods over the next few pages, 
starting with inserting data. 

If you need to prepopulate a SQLite table with data, you can use the 
SQLiteDatabase insert () method. This method allows you to insert 
data into the database, and returns the ID of the record once it’s been inserted. 
If the method is unable to insert the record, it returns a value of -1. 

To use the insert () method, you need to specify the table you want to insert 
into, and the values you’re inserting. You say what values you want to insert by 
creating a ContentValues object. A ContentValues object is used to 
hold name/value pairs of data: 

ContentValues drinkValues = new ContentValues(); 

You add name/value pairs of data to the ContentValues object using its 
put() method. We want to use it to insert a row of data into the DRINK 
table, so we’ll populate it with the name of each column in the DRINK table, 
and the value we want to go in each field: 


java.Iang.Object 


△ 


android.database.sqlite. 

SQLiteDatabase 

execSQL(String) 

insert(String, String, ContentValues) 

update(String, ContentValues, 
String, StringG) 

delete(String, String, StringG) 


The S^li-tcDa-tabasc dlass 

is a subclass o( Object 


ContentValues drinkValues = new ContentValues(); 

drinkValues.put("NAME", "Latte"); 

drinkValues.put("DESCRIPTION", "Espresso and steamed 


This W\W fu*t value 
w £spvcsso ar>d s*tcamcd milk *m 

^ PKCRIPTION dolurny.. 

milk"); 


drinkValues .put ("IMAGE_RESOURCE_ID" , R. drawable . latte) 

Finally, we’ll use the SQLiteDatabase insert () method to insert the 
values into the DRINK table: 




You Y\ttd a sepav-ate ta\\ h> 
pu 七 0 mc*thod -fov cscM 
value you y/a^*t b> 


db.insert("DRINK", null, drinkValues); 

Running these lines of code will insert the Latte record into the DRINK table: 


—id 

NAME 

DESCRIPTION 

IMAGE RESOURCE ID 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 


siVmy Y\t^ vedovd 
yb *mscv-*tcd m*bo 


•the -table- 


The insert () method takes the following general form: 


db.insert(String table. String nullColumnHack, ContentValues values); 


The nullColumnHack String value is optional and most of the time 
you’ll want to set it to null like we did in the code above. It’s there in case the 
ContentValues object is empty and you want to insert an empty row into 
your table. SQLite won’t let you insert an empty row without you specifying 
the name of at least one column; the nullColumnHack parameter allows 
you to specify one of the columns. 


This *msc\rb a sm^lc v-o>w 
m*to 七 he -table- To ms^rt 


multiple vov/s, you Y\tt& 

-to make vcfcaicd tails *to 
*tKc mscv-tO method- 
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SQLite databases 


Update records with the updateH method 

You update existing records in SQLite using the SQLiteDatabase 
update () method. This method allows you to update records in the 
database, and returns the number of records it’s updated. To use the 
update () method, you need to specify the table you want to update 
records in, the values you want to update, and the conditions for updating 
them. Here’s what it looks like: 

public int update (String table, 

ContentValues values. 

String whereClause, 

String[] whereArgs) 


As an example, here’s how you’d change the value of the DESCRIPTION 
column to “Tasty” where the name of the drink is “Latte ”： 


ContentValues drinkValues = new ContentValues(); 

drinkValues .put ("DESCRIPTION", "Tasty") ; ^-Th',s y/'ill Put *tKc value W "Iasty W m i\)t PKCRIPTlON 
db. update ("DRINK", 



Update Ihc DESCRIPTION io w Tasly w 

•m ihe DRIN^ table v/heve — 



id 

NAME 

DESCRIPTION 

IMA6E RES0URCE ID 

1 

“Latte” 

"Tasty" 

54543543 


The first parameter of the update () method is the name of the 
table you want to update (in this case, the DRINK table). 

The second parameter specifies what values you want to update. 

Just as you did with the insert () method, you say what values 
you want to update by creating a ContentValues object to hold 
name/value pairs of data: 

ContentValues drinkValues = new ContentValues(); 
drinkValues . put ('’DESCRIPTION" , "Tasty"); 

The third parameter gives conditions for which records you want 
to update. In the above example, "NAME = ? " means that the 
NAME column should be equal to some value. The ? symbol is 
a placeholder symbol for this value. The query uses the contents 
of the last parameter to say what the value should be (in this case, 
“Latte”). 

You can also specify multiple criteria, and we’ll show you this on 
the next page. 


WatcK it! 


If you set the 
last two 
parameters of 
the update() 
method to null, 


ALL records in the table 


will be updated. 

As an example, the code 


db. update ("DRINK", 

drinkValues, 


null, null); 


will update all records in the 
DRINK table. 
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conditions 


Multiple conditions 



Create database 
Create table 


If you want to apply multiple conditions to your query, you need to make 
sure you specify the conditions in the same order you specify the values. As an 
example, here’s how you’d update records from the DRINK table where the 


name of the drink is “Latte”，or the drink description is “Our best drip coffee”. 

db • update ( n DRINK n , .. A . U| L i w 

This NAME - Latte ov 

pkcription ^ w 0uv best 


drinkValues, 

"NAME = ? OR DESCRIPTION 


new String[] {"Latte", "Our best drip coffee”}); 


The condition values must be Strings, even if the column you’re applying the 
condition to doesn’t contain Strings. If this is the case, you need to convert 
your values to Strings. As an example, here’s how you’d return DRINK 
records where the —id is 1: 

db.update( n DRINK", 

drinkValues, 

"_id = ?▼，， 

new String[] 


Convert I 

*to 3 value. 

{Integer.toString(1)}); 


Pelcte records with the deleted method 


The SQLiteDatabase delete () method works in a similar way to the 
update () method you’ve just seen. It takes the following form: 

public int delete (String table. 

String whereClause, 

String[] whereArgs) 

As an example, here’s how you’d delete all records from the database where 
the name of the drink is “Latte ”： 


db. delete ("DRINK", ^ Car> you see \\ovj similar this is bo i\\t ufdaW) method? 
"NAME = ?，、 

new String [] {"Latte"}) ; The \row is delated 


id NAME DESCRIPTION IMA6E RES0URCE ID 



The first parameter is the name of the table you want to delete records from 
(in this case, DRINK). The second and third arguments allow you to describe 
conditions to specify exactly which records you wish to delete (in this case, 
where NAME = “Latte”). 

Now that you’ve seen the kinds of operations you can do to manipulate data 
in a SQLite table, you have everything that you need to create a SQLite 
database and create tables and prepoplute them with data. On the next page, 
we’ll put this into practice in our SQLite helper code. 
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SQLite databases 


The StarbuzzPatabaseHelper code 

Here’s the complete code for StarbuzzDatabaseHelper.java (update your 
code to reflect our changes): 

package com.hfad.starbuzz; 

import android.content.ContentValues; 

import android.content.Context; 

import android.database.sqlite.SQLiteDatabase; 

import android.database.sqlite.SQLiteOpenHelper; 


class StarbuzzDatabaseHelper extends SQLiteOpenHelper{ 




Create database 
Create table 


□ 

Starbuzz 

L Q 

app/sre/main 

L Q 

java 


com. hfad. starbuzz 

a 

StarbuzzDatabase 

Helper.java 


private static final String DB—NAME = "starbuzz"; // the name of our database 
private static final int DB—VERSION =1; // the version of the database 

_Say >wV>a*t database av\d 

StarbuzzDatabaseHelper(Context context){ VCV-S*IO^ is. |*t’s 七 VCV-S*!Oir> o-f 

super (context, DB—NAME, null, DB_VERSION) ; database, so Mtrs\oY\ should be I- 

ddllcd "tllC dd'idbdSC *Pi\rS 七 

(^Override ^ usm 5 ^ ⑽ ale 七 he tabic msev-t da*ta. 

public void onCreate (SQLiteDatabase db) { 

db. execSQL ("CREATE TABLE DRINK (一 id INTEGER PRIMARY KEY AUTO INCREMENT,，▼ 

+ " NAME text, » ' ^ create the PRIN^ table- 

+ "DESCRIPTION TEXT, ，▼ 

cadh + ’'IMAGE 一 RESOURCE—ID INTEGER );”〉； 

d\r'mk \ y \ d x^insertDrink (db , "Latte" , "Espresso and steamed milk" , R. drawable . latte) ; 
scpa\ra-tc v*ov/. -RinsertDrink (db, "Cappuccino" , "Espresso, hot milk and steamed-milk foam", 

R.drawable.cappuccino); 

insertDrink(db , "Filter", "Our best drip coffee ”， R.drawable.filter); 


\ 


} oy>U^v-adeO yts called y/hcir> da*tabasc v>ccds *to be 

QOverride 厂 upgraded. ‘II Uk aHV>i S 心七 . 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 


private static void insertDrink(SQLiteDatabase db, String name. 

String description, int resourceld) { 
ContentValues drinkValues = new ContentValues(); ^ 

drinkValues.put("NAME", name); 
drinkValues.put("DESCRIPTION", description); 
drinkValues.put("IMAGE_RESOURCE_ID M , resourceld); 
db.insert("DRINK", null, drinkValues); 


Wc y>ccd *to *mscv-*t scvcv-al 
dv-'mks, so >wc dvca*tcd a 
scpav-a*tc method *to do 七 his. 
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what happens 


What the SQLite helper code does 




Create database 
Create table 





The user installs the app and launches it. 

When the app needs to access the database, the SQLite helper checks to see 
if the database already exists. 



SQLite helper 

If the database doesn't exist, it gets created. 

It’s given the name and version number specified in the SQLite helper. 





Name ：、、 starbuzz 〃 
Version ： 1 


SQLite database 


SQLite helper 


When the database is created, the onCreate() method in the 
SQLite helper is called. 

It adds a DRINK table to the database, and populates it with records. 
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SQLite databases 


Cf c ^rpen your pencil 


Here’s the onCreate () method of a SQLiteOpenHelper 

class. Your job is to say what values have been inserted into the 
NAME and DESCRIPTION columns of the DRINK table when the 
onCreate () method has finished running. 


QOverride 

public void onCreate(SQLiteDatabase db) { 

ContentValues espresso = new ContentValues(); 
espresso . put ( n NAME ，'， "Espresso"); 

ContentValues americano = new ContentValues(); 
americano . put ( "NAME""Americano"); 
ContentValues latte = new ContentValues(); 
latte•put( n NAME n , "Latte"); 

ContentValues filter = new ContentValues(); 
filter .put 「 DESCRIPTION' ，， "Filter"); 
ContentValues mochachino = new ContentValues(); 
mochachino.put("NAME M , "Mochachino"); 


db.execSQL ("CREATE TABLE DRINK (，▼ 

+ "_id INTEGER PRIMARY KEY AUTOINCREMENT, 
+ "NAME TEXT , ，， 

+ "DESCRIPTION TEXT);"); 
db • insert ( n DRINK ， ' ， null, espresso); 


db . insert (’'DRINK ，'， 
db.delete( n DRINK n , 
db.insert( n DRINK n , 
db . update ( n DRINK ，'， 
db . insert (’'DRINK ，'， 


null, americano); 
null, null); 
null, latte); 
mochachino, n NAME 
null, filter); 


new String[] {"Espresso"}) 


Y^u doh ; 七 
y\ttA io 
the 

value o-P -the 
id dolumh. 


id 

NAME 

DESCRIPTION 
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sharpen solution 


O^terpen your pencil 


Here’s the onCreate () method of a SQLiteOpenHelper 

class. Your job is to say what values have been inserted into the 
NAME and DESCRIPTION columns of the DRINK table when the 
onCreate () method has finished running. 


QOverride 


public void onCreate(SQLiteDatabase db) { 

ContentValues espresso = new ContentValues(); 
espresso . put ( n NAME ，'， "Espresso"); 

ContentValues americano = new ContentValues(); 
americano . put ( "NAME""Americano"); 
ContentValues latte = new ContentValues(); 
latte•put( n NAME n , "Latte"); 

ContentValues filter = new ContentValues(); 


filter .put 「 DESCRIPTION ， ' ， "Filter"); 
ContentValues mochachino = new ContentValues(); 
mochachino . put ( "NAME ""Mochachino"); 


db.execSQL("CREATE TABLE DRINK 


Create tabic, add'mj 
NAMt) P6SCRIPTI0N 


+ n _id INTEGER PRIMARY KEY AUTOINCREMENT, 
+ "NAME TEXT," 


+ "DESCRIPTION TEXT );，'）； 

db . insert ('’DRINK' null, espresso) ; 七 'm 

db . insert ( "DRINK" , null, americano) ; \y\ the 亡 olurvm. 

null, null) ; ^-Delete all *thc d\r*mb. 
null, latte) ; m "the NAAlE dolimm. 

mochachino, "NAME = ?▼', new String [ ] { "Espresso" }); 

null, filter); Srt MAMB b> MoAadiVmo V/V>c^rc HAMB 


db.delete("DRINK 
db.insert("DRINK 
db . update (’'DRINK 


db . insert ( ， 'DRINK n 

l^i Fil-tcv m ihc DESCRIPTION to\^. 


is Espvcsso. No vedovds yt updated- 


id 

NAME 

DESCRIPTION 


Latte 




Filter 
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SQLite databases 


What if you weed to change the database? 

So far, you’ve seen how to create a SQLite database that your app will 
be able to use to persist data. But what if you need to make changes to 
the database at some future stage? 

As an example, suppose lots of users have already installed your 
Starbuzz app on their devices, and you want to a add a new 
FAVORITE column to the DRINK table. How would you distribute 
this change to new and existing users? 



Well, we could change the CREATE TABLE 
statement in the onCreate() method, but 
that doesn’t feel entirely right to me. I 
mean, what if a device already has the old 
version of the database installed? 




When you need to change an app’s database, 
there are two key scenarios you have to deal with. 

The first scenario is that the user has never installed your app before, 
and doesn’t have the database installed on her device. In this case, 
the SQLite helper creates the database the first time the database 
needs to be accessed, and runs its onCreate () method. 

The second scenario is where the user installs a new version of your 
app which includes a different version of the database. If the SQLite 
helper spots that the database that’s installed is out of date, it will call 
either the onUpgrade () or onDowngrade () method. 

So how can the SQLite helper tell if the database is out of date? 


4^ 


you are here ► 


455 































version numbers 

SQLite databases have a version number 


Upgrade database 


The SQLite helper can tell whether the SQLite database needs updating 
by looking at its version number. You specify the version of the database 
in the SQLite helper by passing it to the SQLiteOpenHelper 
superclass in its constructor. 

Earlier on, we specified the version number of the database like this: 

參 • • 

private static final String DB—NAME = "starbuzz"; 

private static final int DB VERSION = 1; 



Gee} Bits i 


StarbuzzDatabaseHelper(Context context) { 

super (context, DB—NAME, null, DB—VERSION); 


When the database gets created, its version number gets set to the version 
number in the SQLite helper, and the SQLite helper onCreate () 
method gets called. 

When you want to update the database, you change the version number 
in the SQLite helper code. To upgrade the database, specify a number 
that’s larger than you had before, and to downgrade your database, specify 
a number that’s lower: 


SQLite databases support 
a version number that’s 
used by the SQLite helper, 
and an internal schema 
version. Whenever a 
change is made to the 
database schema, such 
as the table structure, 
the database increments 
the schema version by 1. 
You have no control over 
this value, it’s just used 
internally by SQLite. 


private static final int DB VERSION = 2; 


so 


: wcVc md\rcasihg the vcv-sioh 
the database will get 


Most of the time, you’ll want to upgrade the database, so specify a 
number that’s larger. This is because you usually only downgrade your 
database when you want to pull changes you made in a previous upgrade. 

When the user installs the latest version of the app on her device, the 
first time the app needs to use the database, the SQLite helper checks its 
version number against that of the database on the device. 

If the version number in the SQLite helper code is higher than that 
of the database, it calls the SQLite helper onUpgrade () method. If 
the version number in the SQLite helper code is lower than that of the 
database, it calls the onDowngrade () method instead. 

Once it’s called either of these methods, it changes the version number of 
the database to match the version number in the SQLite helper. 
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SQLite databases 


Upgrading the database: an overview 

Here’s what happens when you release a new version of the app 
where you’ve changed the SQLite helper version number from 1 to 2: 



The user installs the new release of the app and runs it. 



User 


Device 




If this is the first time the user has installed the app, the database 
doesn’t exist, so the SQLite helper creates it. 

The SQLite helper gives the database the name and version number specified in the 
SQLite helper code. 



SQLite helper 


SQLite database 


Name ：、、 starbuzz 〃 

Version ： 2 

The S^Li-tc hclfcv 5'ivcs 
database a vcv-s*iov> number 

o( Z i-f *tK*is "is *tV>c vcv*s*ioy> 
spcdi-f 'icd m 
S6^L*i*tc hclfcv- dodc- 


When the database is created, the onCreate() method in the SQLite 
helper is called. 

The onCreate () method includes code to populate the database. 


onCreateQ 



SQLite helper 



DRINK 



SQLite database 


Name ：、、 starbuzz 〃 
Version ： 2 
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what happens 


The story continues... 



If the user installed a previous version of the app and accessed the 
database, the database already exists. 

If the database already exists, the SQLite helper doesn’t re-create it. 



SQLite helper 


DRINK 



SQLite database 


Name ：、、 starbuzz 〃 
Version ： 1 



The SQLite helper checks the version number of the database against 
the version number in the SQLite helper code. 

If the SQLite helper version number is higher than the database version, it calls 
the onUpgrade () method. If the SQLite helper version number is lower than the 
database version, it calls the onDowngrade () method. It then changes the database 
version number to reflect the version number in the SQLite helper code. 



SQLite helper 


Name ：、、 starbuzz 〃 


Version^. 2 

t 

The S 夕 Lrte iiclfcv- vur>s 
oy>UfyadcO method (i-f 
vcv*siov> ruAmbcv" is 
ufda-tes i\)t database \itrs\or\ 
y>umbcv*. 
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SQLite databases 


How the SQLite helper makes decisions 

Here’s a summary of what the SQLite helper does 
depending on whether the database already exists and the 
version number of the database. 



Call onCreate() 




o SQLite helper 

D version = 
database 
version 


SQLite helper /© 
version > 
database 
version 


Call onUpgrade() 



SQLite helper 
version < 
database 
version 

Call onDowngrade() 



database 

downgraded 




If the database doesn't already 
exist, the SQLite helper creates 
the database, and the helper 
onCreateQ method runs. 



If the database already exists, 
the SQIite helper checks the 
version number held on the 
database with the version 
number in the helper. 



If the version number in the 
SQLite helper is larger than 
the version number held on 
the database, the onUpgrade() 
method is called. 

The SQIite helper then updates the 
database version number. 



If the version number in the 
SQLite helper is smaller than 
the version number held on the 
database, the onDowngrade() 
method is called. 

The SQIite helper then updates the 
database version number. 



If the version number in the 
SQLite helper is the same as 
the version number held on the 
database, neither method is 
called. 

The database is already up to date. 


Now that you’ve seen under what circumstances the 
onUpgrade () and onDowngrade () methods get called, 
let’s find out more about how you use them. 
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onilpgradeQ 


Upgrade database 


Upgrade your database with onUpgradeH 


The onUpgrade () method has three parameters — the 
SQLite database, the version number of the database itself, 
and the new version of the database that’s passed to the 
SQLiteOpenHelper superclass: The du\r\re>vt vcv-sio^ 

o ( 七 he database 


@Override 


V 


The Y\t^l VCV-SIO^ 
desdvibed'm 七 he 
hclfcv- todt 


public void onUpgrade(SQLiteDatabase db , int oldVersion, int newVersion) 


//Your code goes here 

} 

The version numbers are important, as you can use them to say 
what database changes should be made depending on which 
version of the database the user already has. As an example, 
suppose you needed to run code when the database is currently at 
version 1. Your code would look like this: 

QOverride 


Rcmcmbcv, *bo uf^vadc 
database, i\\t version must 
be h\ar\ old vcvs'ion. 


public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 

if (oldVersion == 1) { 

//Code to run if the database version is 1 ♦ 


This Code v/ill oY\\y Vuh i-f -the 
“sev’s database is vc\rsio^ I. 


You can also use the version numbers to apply successive updates 
like this: 

©Override 


public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 

if (oldVersion == 1) { 

//Code to run if the database version is 1 Tiiis to&t will or\ly i-f 七 k 

、 usev's database is a*t vevsio^ I. 


if (oldVersion < 3) { 

//Code to run if the database version 


Using this approach means that you can make sure that the user 
gets all the database changes applied that they need, irrespective 
of which version they have installed. 


or 2 ^^ This todt will y\AY\ i-f the 

use/s database is a-t vevsio^ / 
o\r Z. |-f ihc usc\r has vevsio^ 

I of -the database, i-t v/ill 
both sets o( Code- 


The onDowngrade () method works in a similar way to the 
onUpgrade () method. Let’s take a look on the next page. 
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downgrade your database with onPowngradeH 


The onDowngrade () method isn’t used as often as the 
onUpgrade () method, as it’s used to revert your database to 
a previous version. This can be useful if you release a version of 
your app that includes database changes, but you then discover 
that there are bugs. The onDowngrade () method allows you to 
pull the changes and set the database back to its previous version. 

Just like the onUpgrade () method, the onDowngrade () 
method has three parameters — the SQLite database you 
want to downgrade, the version number of the database 
itself, and the new version of the database that’s passed to the 
SQLiteOpenHelper superclass: 

@Override 

public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) { 



//Your code goes here 


Just as with the onUpgrade () method, you can use the version 


numbers to revert changes specific to a particular version. As an 
example, if you needed to make changes to the database when 
the database version number is 3, you’d use code like following: 

QOverride 

public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) { 


if (oldVersion == 3) { 

//Code to run if the database version is 3 


Tiiis Code Will v-ur\ i-f usev 
Ii3s vcv-sior\ ^ o-f d3*tabasc> 
but you y/a 灼七 *to doym^rade i 七 
■to a lowev vc\rsior\. 


Let’s put this into practice by upgrading the database. 
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upgrade the database 

Lcfs upgrade the database 


Upgrade database 


Suppose we need to upgrade our database to add a new column to the DRINK 
table. As we want all new and existing users to get this change, we need to 
make sure that it’s included in both the onCreate () and onUpgrade () 
methods. The onCreate () method will make sure that all new users get the 
new column, and the onUpgrade () method will make sure that all existing 
users get it too. 

Rather than put similar code in both the onCreate () and onUpgrade () 
methods, we’re going to create a separate updateMyDatabase () method, 
called by both the onCreate () and onUpgrade () methods. We’ll 
move the code that’s currently in the onCreate () method to this new 
updateMyDatabase () method, and we’ll add extra code to create the extra 
column. Using this approach means that you can put all of your database code 
in one place, and more easily keep track of what changes you’ve made each 
time you’ve updated the database: 



Starbuzz 



app/sre/main 




java 


com. hfad. starbuzz 

I I 

广 J 

StarbuzzDatabase 

Helper.java 


@Override 

public void onCreate(SQLiteDatabase db){ 

updateMyDatabase(db, 0, DB VERSION); 


^ Raihcir ertait PRIN^ table heire, v/c II 

ouv ufdatcMyPa-tabascO method *to do it 


@0verride 

public void onUpgrade(SQLiteDatabase 

updateMyDatabase(db, oldVersion, 


db, int oldVersion, int newVersion) { 

newVersion) ； Call ihc upda-tc/WyDa-tabascO meihod 心。眯 

-the pavarndcvs. 


private 

if 

This is 七 he 
Code wc 
hdd m ouv* 
o^Cv-caicO 
method. 


void updateMyDatabase(SQLiteDatabase db, int oldVersion, int newVersion) 
(oldVersion < 1) { 

db.execSQL("CREATE TABLE DRINK (—id INTEGER PRIMARY KEY AUTOINCREMENT, ，▼ 

+ "NAME TEXT,，▼ 

+ "DESCRIPTION TEXT,，▼ 

+ "IMAGE 一 RESOURCE—ID INTEGER );，”； 

insertDrink(db , "Latte ", "Espresso and steamed milk", R.drawable.latte); 
insertDrink(db , "Cappuccino", "Espresso, hot milk and steamed-milk foam" 

R.drawable.cappuccino); 

insertDrink(db , "Filter", "Our best drip coffee", R.drawable.filter); 


if (oldVersion < 2) { 

//Code to add the extra column 


■ This dodc v/ill v*ur> i-f usev dlveadY 
has vcv-s*ioy> I o-f da*tabasc- 
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SQLite databases 



BE • SQL 取 吨改 

On the ri^it, you’ll see some SQLite 
helper code. Your job is to play like 
you’re the SQLite helper and 
say \viiicli code will run 
for each of the users 
below. Wve labeled 
the code we want you to 
consider. Wve done the 


first one to start you off. 


User 1 runs the app for the first time. 


• • 


class MyHelper extends SQLiteOpenHelper{ 

StarbuzzDatabaseHelper(Context context){ 
super (context, "fred ", null, 4); 


QOverride 

public void onCreate(SQLiteDatabase db){ 


❹ / /Run code A 


Code K The user doesn't have *thc 

database, so *tKc ohCrca*tcO mrthod \rur\s. 


User 2 has 


User 3 has 


User 4 has 


User 5 has 


User 6 has 


database version 1. 


database version 2. 


database version 3. 


database version 4. 


database version 5. 


QOverride 

public void onUpgrade(SQLiteDatabase db, 

int oldVersion, 
int newVersion){ 
if (oldVersion < 2) { 

/ /Run code B 


o 


if (oldVersion == 3) 
/ /Run code C 


o 


/ /Run code D 


@Override 

public void onDowngrade(SQLiteDatabase db, 

int oldVersion, 
int newVersion){ 
if (oldVersion == 3) { 

/ /Run code E 


❹ 


if (oldVersion < 6) 
/ /Run code F 


o 


you are here ► 
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On the ri^rf: you’ll see some SQLite 
helper code. Your job is to play like 
you’re the SQLite helper and 
say \viiicli code will run 
for each of the users 
below. Wve labeled 
the code we want you to 
consider. Wve done the 
first one to start you off. 

User 1 runs the app for the first time. 


class MyHelper extends SQLiteOpenHelper{ 

StarbuzzDatabaseHelper(Context context){ 
super (context, n fred ", null, 4); 

} ^ r 

T\)C Y\CN VC\rS*lOir> o\ 

@Override is 

public void onCreate(SQLiteDatabase db){ 

© //Run code A The oX^itO r^e-thod will 

ov\\y v-uk> i-P ihc uscv- does 灼’七 
} have 七 he database. 


Code sc^mer\*t A- The user doesn't have *thc 
database, so -the ohCrcatcO mrthod rur\s. 


QOverride 

public void onUpgrade(SQLiteDatabase db. 


User 2 has database version 1. 

Code segmerrt B *thch p. The database needs -to be 
upgraded wi*th old\/c\rsioh 二二 I. 

User 3 has database version 2. 

Code sc^meh*t D. The database Y\tcds h> be 
upgraded wi*th oldVcrsioh 二二 2>. 


User 4 has database version 3. 


int oldVersion, 
int newVersion){ 


if (oldVersion 


/ /Run code 


< 2 ) { 

B ^r-^This will vur^ i-f 

usev- lids \itrs\oY\ I- 


if (oldVersion 


/ /Run code 


== 3) { 

C This will \run i*f "the 
usev- has vcv-sio^ 


Q //Run code d ^TV>*,s w*.II usev- 

lias vcv*s*ioy> I, Z) or ^ 


Code segmerrt C *thcr\ D* The database needs *bo be 
upgraded o\dVcrs\oY\ 二 二孓 . 

User 5 has database version 4. 

hlone. The user has *thc dor\rcd*t version 

database. 

User 6 has database version 5. 

Code segmerrt F The database Y\ttds -to be 
doym^rdded wi*th oldVersion 二二 5 . 
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@Override 

public void onDowngrade(SQLiteDatabase db, 

int oldVersion, 
int newVersion){ 


if 

❹ 


if 


o 


(oldVersion =: 
/ /Run code E 


3) 



(oldVersion < 
/ /Run code F 


6 ) 


This will r^cvcv 
\ruh. I*P 七 he usev- 
has vc\rsior> Z, hc\r 
database needs 
■to be upgraded, 
⑽七 doymyaded. 


This will V"uir> i-f usev - i^3s vcv"Sioy> - Fov 
or>Pov/^yadcO bo vu^, {\\t usev must have 
a vcv*s*ior> ^vca*tcv *thav> 千 ， as s 七 he 
duv*v*cv>*t vcv*siov> r>umbcv* o( hclfcv*. 



Upgrading an existing database 


When you need to upgrade your database, there are two types of actions 
you might want to perform: 

Earlier on in the chapter, you saw how to insert, update, or delete records in 
your database using the SQLiteDatabase insert (), update (), and 
delete () methods. You may add more records when you upgrade the 
database, or change or remove the records that are already there. 

You’ve already seen how you can create tables in the database. You may 
also want to add columns to existing tables, rename tables, or remove tables 
completely. 


o Change the database structure. 


o Change the database records. 


We’ll look at how to perform these actions over the next few pages, 
starting with changing the database structure to add columns to existing 
tables. 


Add new columns to tables using SQL 


Earlier on in the chapter, you saw how you could create tables using the 
SQL CREATE TABLE command like this: 

The」dl dolumr^ is fvimavy key. 

PC 一 

CREATE TABLE DRINK ( id INTEGER PRIMARY KEY AUTOINCREMENT, 


/ 

The name 

The table doluwms 


NAME TEXT, 

DESCRIPTION TEXT, 

今 IMAGE—RESOURCE_ID INTEGER) 


You can also use SQL to change an existing table using the ALTER 
TABLE command. As an example, here’s what the command looks like 
to add a column to a table: 

少一 The -table 

ALTER TABLE DRINK ( 

ADD COLUMN FAVORITE NUMERIC The you "to add 

In the example above, we’re adding a column called FAVORITE that 
holds numeric values to the DRINK table. 

On the next page, we’ll show you how to rename a table, or remove it 
from the database. 


SQLite databases 

Upgrade database 
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465 



altering tables 


Upgrade database 



Renaming tables 

You can also use the ALTER TABLE command to rename a table. As 
an example, here’s how you’d rename the DRINK table to FOO: 

ALTER TABLE DRINK bb，C 

RENAME TO FOO^^Thc of "the table 

Pelcte tables by dropping them 

In addition to creating and altering tables, you can delete them using 
the DROP TABLE command: 

DROP TABLE DRINK The <Jc 七 he table you *to VCmoVC 

This command is useful if you have a table in your database schema 
that you know you don’t need any more, and want to remove it in 
order to save space. 


Execute the SQL using execSQLO 

As you saw earlier in the chapter, you can execute SQL commands 
using the SQLiteDatabase execSQL () method: 

SQLiteDatabase.execSQL(String sql); 


As an example, here’s how you’d execute SQL to add a new 
FAVORITE column to the DRINK table: 

db.execSQL("ALTER TABLE DRINK ADD COLUMN FAVORITE NUMERIC; M ); 

You can use the execSQL () method any time you need to execute 
SQL on the database. 

Now that you’ve seen the sorts of actions you might want to 
perform when upgrading your database, let’s apply this to 
StarbuzzDatabaseHelper.java. 
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The full SQLite helper code 


Here’s the full code for StarbuzzDatabaseHelper.java that will add a 
new FAVORITE column to the DRINK table. Update your code to 
match ours (the changes are in bold): 

package com.hfad.starbuzz; 

import android.content.ContentValues; 
import android.content.Context; 
import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 


class StarbuzzDatabaseHelper extends SQLiteOpenHelper{ 


□ 


Starbuzz 


L Q 

app/sre/main 


java 

LQ 

com. hfad. starbuzz 

Id 

StarbuzzDatabase 

Helper.java 


private static final String DB—NAME = "starbuzz"; // the name of our database 

private static final int DB VERSION =2; // the version of the database 



StarbuzzDatabaseHelper(Context context){ 

super (context, DB NAME, null, DB VERSION); 


vcv-s*ioir> y>umbcv *to a lav-^cv* 
enables i\\t S<$L*i*tc hdpcv- *to 
sfo*t you >war>*t *to uf^v-adc 
database. 


QOverride 

public void onCreate(SQLiteDatabase db) { 

updateMyDatabase(db, 0, DB VERSION); 


iA/lc II "the Code -the 

rwc-thod *m -the upda-tc/WyDatabascO mc-thod. 


@Override 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 

updateMyDatabase(db, oldVersion, newVersion); 

} 又 Tiic Code *to upyadc database is 

•m our ufdaicMyPaiabascO mrtiiod. 


TiiC toAt doyrtmues ovcv- 
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more code 

The SQLite helper code (continued) 



Upgrade database 


private void updateMyDatabase(SQLiteDatabase db, int oldVersion, int newVersion) { 
if (oldVersion < 1) { 

db.execSQL("CREATE TABLE DRINK ( 一 id INTEGER PRIMARY KEY AUTOINCREMENT, ，▼ 

+ "NAME TEXT, ，▼ 

+ "DESCRIPTION TEXT, ，▼ 

+ n IMAGE_RESOURCE_ID INTEGER );，'）； 

insertDrink(db, "Latte", "Espresso and steamed milk", R.drawable.latte); 
insertDrink(db, "Cappuccino", "Espresso , hot milk and steamed-milk foam", 

R.drawable.cappuccino); 

insertDrink(db, "Filter ", "Our best drip coffee ", R.drawable.filter); 


if (oldVersion < 2) { 

db. execSQL ("ALTER TABLE DRINK ADD COLUMN FAVORITE NUMERIC;， 1 ); 

} ^ 

Add d y>umCV*'id FAVORITE 

dolumr^ *fco PRIN^ 'table- 


private static void insertDrink(SQLiteDatabase db. String name. 

String description, int resourceld) { 
ContentValues drinkValues = new ContentValues(); 
drinkValues . put ( "NAME"name); 
drinkValues • put (’'DESCRIPTION' ，， description); 
drinkValues•put( n IMAGE_RESOURCE_ID n , resourceld); 
db•insert( n DRINK n , null, drinkValues); 


The new code in the SQLite helper means that existing users will 
get the new FAVORITE column added to the DRINK table the 
next time they access the database. It also means that any new 
users will get the complete database created for them, including 
the new column. 

We’ll go through what happens when the code runs on the next 
page. 
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What happens when the code ruws 




When the database first needs to be accessed, the SQLite helper checks 
whether the database already exists. 



SQLite helper 


If the database doesn't exist, the SQLite helper creates it and runs its 
onCreate() method. 

Our onCreate () method code calls the updateMyDatabase () method. This creates the 
DRINK table (including the extra column) and populates the table with records. 


onCreoteQ 


SQLite helper 


DRINK 



SQLite database 



Name ：、、 starbuzz 〃 
Version ： 2 



If the database already exists, the SQLite helper checks the version number 
of the database against the version number in the SQLite helper code. 

If the SQLite helper version number is higher than the database version, it calls the 
onUpgrade () method. If the SQLite helper version number is lower than the database 
version, it calls the onDowngrade () method. Our SQLite helper version number is 
higher than that of the database, so the onUpgrade () method is called. It calls the 
updateMyDatabase () method, and this adds an extra column called FAVORITE to the 
DRINK table. 



Name ：、、 starbuzz 〃 
Versionr^C2 


SQLite helper 
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toolbox 



Your Android Toolbox 

You’ve got Chapter 11 under 
your belt and now you’ve 
added creating, updating, 
and upgrading databases to your 


You c^y\ download 
-full code ^OV 

Wt 切 

HcadPtv-stA^dvoid. 


toolbox. 



BULLET POINTS 


■ Android uses SQLite as its backend 
database to persist data. 

■ The SQLiteDatabase class gives 
you access to the SQLite database. 

■ A SQLite helper lets you create and 
manage SQLite databases. You create 
a SQLite helper by extending the 

SQLiteOpenHelper class. 

■ You must implement the 

SQLiteOpenHelperonCreate() 
and onUpgrade () methods. 


■ 


The database gets created the first time it 
needs to be accessed. You need to give 
the database a name and version number, 
starting at 1. If you don’t give the database 
a name, it will just get created in memory. 


■ The onCreate () method gets called 
when the database first gets created. 

■ The onUpgrade () method gets called 
when the database needs to be upgraded. 


■ 


Execute SQL using the 

SQLiteDatabase 
execSQL (String) method. 

■ Add records to tables using the 
insert () method. 

■ Update records using the update () 
method. 

■ Remove records from tables using the 
delete () method. 


II K3X PH. VH3 
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12 cursors and cisynctcisks 




Connecting to Databases ♦ 





So how do you connect your app to a SQLite database? 

So far you’ve seen how to create a SQLite database using a SQLite helper. The next step 
is to get your activities to access it. In this chapter, you’ll find out how to use cursors to 
get data from the database, how to navigate cursors, and how to get data from them 
You’ll then find out how to use cursor adapters to connect them to list views. Finally, 
you’ll see how writing efficient multithreaded code with AsyncTasks will keep your app 
speedy. 


this is a new chapter 















where we are 


The story so far 


In Chapter 11, you saw how to write a SQLite helper to 
create a database, and how to add tables and prepopulate 
them with data. You also saw how to make the SQLite 
helper deal with database upgrades so that you can change 
the structure of the database and manipulate the data it 
contains by upgrading it. 

In this chapter, we’re going to show you how to get your 
activities to interact with the database so that your user can 
read from and write to the database using your app. 

Here’s the current state of our Starbuzz app: 


l/Vc^vc dv-ca*tcd i\\t hclfcv- 

added dodc so *i*t dvca*tc 

七 he Siav-buzz. database. \{!s moi 
used by ar^ adtiv'itics yc*t. 



Starbuzz 

database 


SQLite Helper 


The Dv’mk dass is s 七 ill bemg used- 





activity—top—level.xml 


Drink.java 


activity—drink.xml 



Device 


TopLevel Activity .java 


DrinkCategoryActivity.java DrinkActivity.java 


We’re going to change the Starbuzz app so that it uses the 
Starbuzz SQLite database instead of the Java Drink class. 


3ir>d 

PvmkCatc^ov-YA^t^^Y avc 
still Pv-mk.java- 
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Well change the app to use the database 


There are two activities that use the Drink class. We need to get them 
to read data from the SQLite database with assistance from the SQLite 
helper. Here’s what we’ll do: 



Update the Drink code in Dr ink Activity. 

DrinkActivity uses the Drink class to display the details it has for a 
given drink. We’ll change the activity so that it retrieves the record for that 
drink from the Starbuzz database. 



Update the Drink code in DrinkCategoryActivity. 

DrinkCategoryActivity uses the Drink class to display a list of 
all the drinks. We’ll change this so that the activity displays a list of all the 
records in the DRINK table. 



Let users choose their favorite drinks. 

In Chapter 11, we upgraded the database so that the DRINK table 
includes a FAVORITE column. We’ll change the app so that users can 
flag which drinks are their favorites, and display a list of these favorites in 
TopLevelActivity. 


Here’s what the structure of the app will look like: 



activity—top—level.xml 




Starbuzz 

database 



SQLite Helper 


activity—drink.xml 



Device 


TopLevel Activity .java 


DrinkCategoryActivity.java 



DrinkActivity.java 


Let’s start with DrinkActivity.java . 


iVell -the activities -that 
access -the D\rmk dlass so iha 七 -they 
use -the database msicad- 
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current DrinkActivity code 


The current PriwkActivity code 

Here’s a reminder of what the current DrinkActivity.java code looks 
like. The onCreate () method gets the drink number selected 
by the user, gets the drink details from the Drink class, and then 
populates the activity’s views using the drink attributes: 

package com.hfad.starbuzz; 


import android.app.Activity; 
import android.os.Bundle; 
import android.widget. 工 mageView; 
import android.widget.TextView; 

public class DrinkActivity extends Activity 

public static final String EXTRA DRINKNO 


DrinkActivity 

DrinkCategoryActivity 

Favorites 



10:48 


displays details o( 
*tKc dv*'mk usev* 
sclcd*tcd- 


;appuccino 

: spresso, hot milk, and a steamed milk foam 


@Override 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity drink); 



'drinkNo 


com. hfad.starbuzz 


I ltu« 

Id 


DrinkActivity.java 


This is 七 he dhrmk 七 he usev- selected. 

//Get the drink from the intent 令 

int drinkNo = (工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 

Drink drink = Drink. drinks [drinkNo] ; - 七 he dv~'mk -fvom *thc m 七⑼七 *to yt 

dv-'mk irv-om i\\t iVmk dlass. We'll v\ttA *to 

//Populate the drink image *tKis so drmk domes -fvorw database- 

ImageView photo = (工 mageView)findViewByld(R.id.photo); 

photo.setlmageResource(drink.getlmageResourceId()); 
photo.setContentDescription(drink.getName()); 




// Populate the drink name 
TextView name = (TextView)findViewByld(R.id.name); 

name.setText(drink.getName()); 


v\ccd -to fopulaic 七 he 
views m ihc layoui wiih 
values -Pv-orw 七 he dd'tdbdse, 
灼 0 七 -Pv-om ihc Dv-'mk dlass. 


// Populate the drink description 

TextView description = (TextView)findViewByld(R•id•description); 

description.setText(drink.getDescription()); 
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fret data from the database with a cursor 

Our current DrinkActivity code depends on being able 
to get details of a particular drink from the Drink class. How 
do we change this so that we can retrieve drink details from the 
Starbuzz database instead? How do you change an activity so that it 
reads data from a database? 

The solution is to use a cursor. 

Cursors give you access to database data 

A cursor gives you access to database recordsets. You specify 
what data you want access to, and the cursor brings back the 
records from the database. You then navigate through the records 
supplied by the cursor. 



You create a cursor by specifying what data you want access to 
using a database query. So what’s a query? 
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query overview 

A query lets you say what records 
you wawt from the database 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


A database query gives you a way of saying exactly which records you want access 
to from the database. As an example, you can say you want to access all the data 
from the DRINK table, or just those drinks whose name begins with “L”. The 
more you can restrict the data you return, the more efficient your query will be. 

Specify the table and columns 


The first thing to specify in your query is which table you want 
to get records from, and which columns you need. 



Re 七 uv^ 七 he daia -f Vom i\\t MAMB ay\d 
PKCRIPTION dolumy>s m iht PRIN^ table. 


—id 

NAME 

DESCRIPTION 

IMAGE RESOURCE ID 

FAVORITE 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 

0 

S 

“Cappuccino” 

"Espresso, hot milk and 

654334453 

0 



steamed-milk foam" 



3 

“Filter” 

"Our best drip coffee" 

443S4S34 

0 


Peclare any conditions that restrict your selection 

Once you’ve said what columns you want, you can filter your data by 
declaring any conditions the data must meet. In our app, for example, we 
want to retrieve the drink the user selected, and we can do this by only 
returning records where the drink _id has a particular value. 



\wV>cvc 
•id is I. 


id 

NAME 

DESCRIPTION 

IMA6E RES0URCE ID 

FAVORITE 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 

0 

S 

“Cappuccino” 

"Espresso, hot milk and 
steamed-milk foam" 

654334453 

0 

3 

“Filter” 

"Our best drip coffee" 

443S4S34 

0 


Other stuff you can use queries for 

If you expect your query to return several rows of data, you might find 
it useful to say what order you want the records to be in. As an example, 
you might want to order the drink records in drink name order. You 
can also use queries to group the data in some way, and apply aggregate 
functions to it. As an example, you might want to return a count of how 
many drinks there are and display it in your app. 

So how do you create a query? 
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The SQLitePatabase queryO method 
lets you build SQL using a query builder 

You can build a query using the SQLiteDatabase 
query () method. The query () method returns an object 
of type Cursor, which your activities can use to access the 
database. 

Here is the basic form of the query () method: 


public Cursor query(String table, ^ 


The method 

V"C*tuV"\r\S d CuV"SO\r- 




The table 釙 d dolum^s you v/arrt *to adtess. 


String[] columns. 

String selection, WsC 栎仪』 产娜七伤 a PP'Y ⑽础 ⑽ s . 

String[] selectionArgs , 


String groupBy 
String having 


,^ - "these i-f you v/av\i io agycjaic ihc data. 

String orderBy) ^ ^ ^ ^ ^ ^ ^ a ㈣ 。咖？ 


You can use this version of the query () method to specify 
which table you want to return data from, which columns 
you want, what conditions you want to apply to the data, 
what data aggregations you need, and how you want the data 
ordered. 

There are several other overloaded versions of the query () 
method which allow you to add extra details to your query, 
such as whether you want each row to be unique, and 
the maximum number of rows you want to be returned. 

We’re not going to go into all these variations, but if you’re 
interested, you can find a full list of the overloaded methods 
in the online Android documentation: 

http:/ / developer, android, com/reference/android/database/ 
sqlite/SQLiteDatabase. html 

Over the next few pages, we’ll go through some of the most 
common ways in which you might want to use the query () 
method. 


Bekinct tke scenes, 
Anctroid uses tke 
queryO itietkoct to 
construct an SQL 
SELECT statement. 
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tables and columns 

Specifying table and columns 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


The simplest type of database query you can create is to return all 
the records for particular columns without specifying criteria. To do 
this, put the name of the table as the first parameter, and a String 
array of the column names as the second. As an example, here’s 
how you’d use the query () method to return the contents of the 
name and description columns from the DRINK table: 

Cursor cursor = db.query("DRINK ", 

new String[] {"NAME", 

This O^ly uses ihc (\rsi Uo ^ nullf null, null, null 

pa\rarwctc\rs ; \\Cv\Ct ihc m\\ values. 


Pu 七 eddV) you v/3^*b ksdk 3s d 

separate value "m a S-tv-'mj av-v-ay- 

)C 

"DESCRIPTION"}, 

, null); 


TiiC V^tiAV* 灼 s all 

the NAME PKCRIPTION 

dolumy>s m PRIN^ 七 able. 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed milk" 

“Cappuccino” 

"Espresso, hot milk and 


steamed-milk foam" 

“Filter” 

"Our best drip coffee" 


Restrict your query by applying conditions 

You can apply conditions to your database query by specifying what 
values particular columns should have using the third and fourth 
query parameters. As an example, here’s how you’d say you only 
want to return records from the DRINK table where the name of 
the drink is “Latte ”： 


Cursor cursor = db • query (▼▼ DRINK ，'， 

new String[] {"NAME", "DESCRIPTION”}, 

▼’NAME = ?' -- This ihc 

new String[] {"Latte"}, "the hlAAjB dolumir) is { LsHe w - 

null, null, null); 

The third parameter "NAME = ? " means that the NAME column 
should equal some value. The ? symbol is a placeholder symbol for 
this value. The query uses the contents of the fourth parameter to 
say what the value should be (in this case, “Latte”). 

V*C*tuV*y>S dll d3"tci ^V*om 

ay>a DESCRIPTION dolumy>s m PRIN^ iablc^~^ 
v/heve 七 he value o-f MAMB- dolumir> is La"t*tc - 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed milk" 
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Applying multiple conditions to your query 

If you want to apply multiple conditions to your query, you 
need to make sure you specify the conditions in the same order 
you specify the values. As an example, here’s how you’d return 
records from the DRINK table where the name of the drink is 
“Latte”，or the drink description is “Our best drip coffee”. 


Cursor cursor = db • query (’ 'DRINK", •• 

nSW string [] 「 NAME' -DESCRIPTION-}, 1 


"NAME = ? OR DESCRIPTION 
new String[] {"Latte"," 

null, null, null); 


=? ” ， < 一 ^ bcsi dr\ ? 
Our best drip coffee "}, 


The <\ucvy ve 七 uws all 七 he data -fvom {Mt MAMB 
DESCRIPTION dol_y>s m 七 k PRIN^ table 

value o( i\\t NAME dolumy> is “Latte” or 七 he value 
七 he PKCRIPTION dolumy> IS w 0uv best dnf 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed milk" 

“Filter” 

"Our best drip coffee" 


If you specify the conditions in a different order to the values, 
your cursor will return the wrong data. As an example, it might 
pair the value “Latte” with the DESCRIPTION column rather 
than the NAME column. This wouldn’t return any records. 


You specify conditions as String values 


The condition values must be Strings. If the column you’re 
applying the condition to doesn’t contain text, you still need to 
convert your values to Strings. As an example, here’s how 
you’d return DRINK records where the _id is 1 : 


Cursor cursor = db.query("Drink ", 

new String [ ] { "NAME", "DESCRIPTION，，}, 


n _id = ? n , 

new String[] {Integer.toString(1)}, 

null, null, null); 



Coy>vcv*t I 

*to 3 S*brnr^ value- 


The c^uevy vrtuv^s all 七 he da*ta -fv-om i\\t MAMB 

ar^d DESCRIPTION toW^s m the PRIN^ table —^ 

y/^cv-c *tv>c value o( *thc id dolumr> is I. 


id 

NAME 

DESCRIPTION 

1 

“Latte” 

"Espresso and steamed milk" 
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order 

Order data m your query 

If you want to display data in your app in a particular order, you 
can use the query to sort the data by a particular column. This 
can be useful if, for example, you want to display drink names in 
alphabetical order. 

By default, the data in the table appears in _id order as this was 
the order in which data was entered: 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


Jd 

NAME 

DESCRIPTION 

IMAGE RESOURCE ID 

FAVORITE 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 

1 

2 

“Cappuccino” 

"Espresso, hot milk and 
steamed-milk foam" 

654334453 

0 

3 

“Filter” 

"Our best drip coffee" 

44324S34 

0 


If you wanted to retrieve data from the NAME and FAVORITE 
column in ascending NAME order, you could use the following: 


Cursor cursor = db•query("DRINK ”， 

new String [] { n _id n , "NAME", "FAVORITE，'}, 

null, null, null, null, 

"NAME ASC") ; . , , l/Ai 〆 

OyAct by hlfiA/lB \y\ ov-dev*. 


NAME 

FAVORITE 

“Cappuccino” 

0 

“Filter” 

0 

“Latte” 

1 


The ASG keyword means that you want to order that column 
in ascending order. Columns are ordered in ascending order by 
default, so if you want you can omit the ASG. To order the data 
in descending order instead, you’d use DESG. 



You can sort by multiple columns too. As an example, here’s how 
you’d order by FAVORITE in descending order, followed by 
NAME in ascending order: 


Cursor cursor = db • query (▼ ， DRINK ”， 

new String [] { n _id n , "NAME", "FAVORITE，'}, 
null, null, null, null, 

"FAVORITE DESC, NAME") Order by FfiVOKlTB 

ov-dev*, 

\ y \ ovdev-. 

You’ve now seen the most common ways of using the query () 
method, but there are still more things you can do. 
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Using SQL functions m queries 

If you’re familiar with SQL functions, the great news is you 
can use them in queries. They allow you to retrieve things like 
the number of rows in a table, the average value of a column, 
or the highest value. 

Here are some of the most useful SQL functions you can use in 
your queries: 


AVG() 

The average value 

COUNT() 

The number of rows 

SUM() 

The sum 

MAX() 

The largest value 

MIN() 

The smallest value 


As an example, if you wanted to count how many drinks there 
are in the DRINK table, you could use the SQL COUNT () 
function to count the number of values in the id column: 


Cursor cursor 


db.query( n DRINK n , 

new String[] 
null, null, null, null, null); 


"TlVis \rctu\nr>s "the o-P dv*inks .m d 

labeled ’’do ⑽七 ” 

COUNT( id) AS count "}, 


TKc c^uevy vc*tuvr>s *thc r>umbcv- 
of vo>ws 七 he PRIN^ table. - 


count 


If the DRINK table contained an extra PRICE column that 
gave the price of each drink, you could find out the average 
drink price using the SQL AVG () function to find the average 
value of the PRICE column: 


Cursor cursor = db.query("DRINK", 

new String[] { "AVG(PRICE) AS price "}, 

null, null, null, null, null); 

Ouv PRIN^ -table docs^*t toY\ia'\Y\ a 
- ^ PRICE bu*t i-f *i*t d\A, y/c dould 

use \i bo -the avcira^c dr\rk 


price 

4.17 
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more sql 

m frROUP PY and HAVING clauses 

If you’re familiar with the GROUP BY and HAVING clauses 
of SQL, you can use these in the fifth and sixth parameters of 
the query () method. 

As an example, suppose you wanted to find out how many 
drinks there are for each value of FAVORITE. To do this, 
you’d create a query to return the FAVORITE column and a 
count of drinks. You’d then group by the FAVORITE column 
to return the number of drinks there are for each value of 
FAVORITE: 


DrinkActivity 

DrinkCategoryActivity 

Favorites 



We’re not teaching 
you SQL in this 
book, just giving 
you a glimpse of 
what you can do. 


If you think this is something you’ll 
find useful, we suggest picking up a 
copy of Head First SQL. 


Cursor cursor = db.query( M DRINK", 

new String[] 
null, null, 

by FAVORITE 广 > "FAVORITE% 

null, null); 


{"FAVORITE", "COUNT ( 一 id) AS count”}, 

\T 一 

ihe FAVORITB dolu. 

"the hurwbev- o-p dHhks. 




If the data in the DRINKS table looks like this: 


id 

NAME 

DESCRIPTION 

IMAGE RESOURCE ID 

FAVORITE 

1 

“Latte” 

"Espresso and steamed milk" 

54543543 

1 

2 

“Cappuccino” 

"Espresso, hot milk and 
steamed-milk foam" 

654334453 

0 

3 

“Filter” 

"Our best drip coffee" 

443S4S34 

0 


the query will return data like this: 


FAVORITE 

count 

1 

1 

0 




/ 

TKcv*c s I dhrmk FAVORITE Kas s vdluc o-f I 
a^di 2 - dv-*mks y/Kcv-c FAVORITE Kas a value of O. 


) 


Now that you’ve seen how to create a cursor using the 
query () method, it’s time for you to have a go at creating one 
for the Starbuzz app. 
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Cocte Magnets 

In our code for DrinkActivity, we want to get the name, 
description, and image resource ID for the drink passed to it in an 
intent. Can you construct a query () method that will do that? 


int drinkNo = (工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 

Cursor cursor = db.query( , 

new String[] { , , }, 


new String[] 




null, null,null); 





r^j 


[ : NAME。 [ drinkNo^ 



Q 


I toString"| 


□ 


□ 


□ 


□ 


'DESCRIPTION- 


f : , DRINK ，」 


you are here ► 483 



























magnets solution 



Cocte Magnets Solution 



In our code for DrinkActivity we want to get the name, 
description and image resource ID for the drink passed to it in an 
intent. Can you construct a query () method that will do that? 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 

\Mt -to ^utss PRIN^ "tabic. 


Cursor cursor = db.query( 


new String[] 



I "NAME" I 


七七 "the DESCRIPTION ar>a m^B_KBSOURCB JD co\^s. 

， 心一 



G3.E31I1. 


Jd maUV^cs i\\t dv-'mkNo. 

一 V 


new String[] { 


厂 Integer | | . 飞 | toString^ 「( drinkNo^ ~7j 




null, null,null); 


d\r*mk/Vo is dr> nvt; so heeded "to 

be ^ohvcv-tcd -fco a 




fret a reference to the database 

Over the past few pages, you’ve seen how to build a query that returns 
a cursor. The query () method is defined in the SQLiteDatabase 
class, which means in order to call it we need to get a reference to our 
Starbuzz database. The SQLiteOpenHelper class implements a couple 
of methods that can help us with this: getReadableDatabase () and 
getWritableDatabase () . Each of these methods returns an object of 
type SQLiteDatabase, which gives us access to the database. You call the 
methods like this: 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 

SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 

and 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 

SQLiteDatabase db = starbuzzDatabaseHelper.getWritableDatabase(); 


A cursor lets you 
read data Irom 
tke database. 


So what’s the difference between these two methods? 
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getReadablePatabaseH versus 
gctWritablePatabaseO 


You’re probably thinking that getReadableDatabase () returns a 
read-only database object, and getWritableDatabase () returns one 
that’s writable. In fact, most of the time getReadableDatabase () and 
getWritableDatabase () both return a reference to the same 
database object. This database object can be used to read and write data 
to the database. So why is there a getReadableDatabase () method if 
it returns the same object as the getWriteableDatabase () method? 

The key difference between the getReadableDatabase () and 
getWritableDatabase () methods is what happens if it’s not possible 
to write to the database. This can happen if the disk is full, for instance. 


If you use the getWritableDatabase () method in this case, the 
method will fail, and throw a SQLiteException. But if you use the 
getReadableDatabase () method, the method will try to get a read¬ 
only reference to the database. It may still throw a SQLiteException if it 
can’t get read-only access to the database. 

If you only need read data from a database, you’re best off using the 
getReadableDatabase () method. If you need to write to the database, 
use the getWritableDatabase () method instead. 


You II yvobably be able *to *to 
dd*bdbdsc i-f you use 

bu*t its v>o*t 


getReadablePatabaseH 


备 et read/write 
.access to database. 


Fail 


Success 



Writable 

Database 


备 et read-only 
.access to database. 


Success 



Fail 


SQLiteException 


Readable 

Database 


(yrtReadablePabbaseOtvies 代 ad/W •心 

adtess bo database -f 'ivst l-f \i -fails, V'cs 

{p yt vcad-or\ly addess *to 七 ^ database, l-r i*t still 
adtess, it 七 Wows a S^Li*tc6%dcp*tion. 


gctWritablePatabascO 


^et read/write \ Success 

.access to database. 



Writable 

Database 


Fail 

grtlAAritableDaiabaseO ivies -to 

ge 七 v-cad/v/v-i-tc adtess -to 七 he 
database- i-t (ails, _七 ihvows 


SQLiteException 
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cursor code 

The code for getting a cursor 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


Putting all of this together, here’s the code for getting a cursor. We’ll 
use this code later in the onCreate () method of our activity. 

try { 

SQLiteOpenHelper starbuzzDatabaseHelper — new StarbuzzDatabaseHelper(this); i 

SQLiteDatabase db 二 starbuzzDatabaseHelper.getReadableDatabase(); _ 

Cursor cursor = db•query( n DRINK", 

new String [] {"NAME", "DESCRIPTION ，，， n IMAGE—RESOURCE_ID n }, 


Wt doh t heed "fco v/iritc bo 
"Bit so wcVc usih^ 

gctRcadablcDatabascO. 


//Code to do something 


"_id = ? n , 

new String[] {Integer.toString(drinkNo) 

null, null,null); 

■ , K K Wc "the duvsov*. 

with the cursor ; 

but v/c still y\ctd xo 


The tuvsov 

} £.oh*bd'ms 3 sm^lc 

vedovd as *tV>c — id 

dolum 灼 doy>*t3ms 

uy>'i^ue v-cdovds. 


catch(SQLiteException e) { 

Toast toast = Toast.makeText(this 
toast.show(); 




do sorwethmj y/rth i*t. 

,"Database unavailable". Toast•LENGTH—SHORT); 

Display 3 message i-f database is unavailable. 


What the code does 


o 

❺ 


The starbuzzDatabaseHelper is created. 



starbuzzDatabaseHelper 

starbuzzDatabaseHelper creates a SQLiteDatabase object called db. 




starbuzzDatabaseHelper db 

The cursor is created by calling the SQLite Database query() method. 
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To read a record from a cursor, 
you first need to navigate to it 

You’ve now seen how to create a cursor; you use the 
SQLiteDatabase query () method to say what data you 
want the cursor to return. But that’s not the end of the story — 
we need to read values from it. 

Whenever you need to retrieve values from a particular record 
in a cursor, you first need to navigate to that record. You need 
to do this irrespective of how many records are returned by 
the cursor. 



On the next page, we’ll look at how you navigate cursors. 
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moving through cursors 

Navigating cursors 

There are four main methods you use to navigate through the records 
in a cursor. These methods are moveToFirst (), moveToLast (), 
moveToPrevious(), and moveToNext (). 

To get access to the first record returned by the cursor, you can use its 
moveToFirst () method (it returns a value of true if it finds a 
record, and false if the cursor hasn’t returned any records): 

if (cursor.moveToFirst()) { 

//Do something 


If you want to navigate to the last record returned by the cursor, 
you can use the moveToLast () method instead (just like the 
moveToFirst () method, it returns a value of true if it finds a 
record, and false if it doesn’t): 


if (cursor.moveToLast()) { 

//Do something 


To iterate through the records in the cursor, you use the 
moveToPrevious () and moveToNext () methods. 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


/V\oMt *to *tV)C v-oy/. 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed 


milk" 

Cappuccino 

"Espresso, hot milk and 


steamed-milk foam" 

Filter 

"Our best drip coffee" 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed 
milk" 

Cappuccino 

"Espresso, hot milk and 
steamed-milk foam" 

Filter 

"Our best drip coffee" 


Move -fco the las-t 


v*ow. 


The moveToPrevious () method moves you to the previous record 
in the cursor (it returns true if it succeeds in moving to the previous 
record, and false if it fails — which could be because it’s already at the 
first record, or because the cursor doesn’t contain any records): 

if (cursor.moveToPrevious()) { 

//Do something 


The moveToNext () method works in the same way as the 
moveToPrevious () method, except that it moves you to the next 
record in the cursor (it returns true if it succeeds in moving to the next 
record, and false if it fails): 

if (cursor.moveToNext()) { 

//Do something 

}； 

Once you’ve navigated to a record in your cursor, you can access its 
values. We’ll look at that on the next page. 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed 
milk" 

Cappuccino 

"Espresso, hot milk and 
steamed-milk foam" 

Filter 

"Our best drip coffee" 



Move *fco pv-cv*ious voy/. 


NAME 

DESCRIPTION 

“Latte” 

"Espresso and steamed 
milk" 

Cappuccino 

"Espresso, hot milk and 
steamed-milk foam" 

Filter 

"Our best drip coffee" 


Move -fco -the V-OW. 
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ftettiwg cursor values 


Once you’ve moved to a record in a cursor, you can retrieve values 
from it so that you can display them in your activity’s views. You 
retrieve a value from the current record in a cursor using its get* () 
methods. The exact method you use for this depends on the type 
of value you want to retrieve. As an example, the getString () 
method returns the value of a column as a String, and the 
getlnt () method returns the value of a column as an int. Each of 
the methods takes a single parameter, the column index. 

As an example, here’s the query we used to create our cursor: 


Cursor cursor = db.query ("Drink ", 

new String [ ] { "NAME", "DESCRIPTION ， ' ， ，，工 MAGE—RESOURCE_ID n }, 

n _id = ? n , 

new String[] {Integer•toString(1)}, 

null, null,null); 


The cursor has three columns: NAME, DESCRIPTION, and 
IMAGE RESOURCE ID. The first two columns, NAME and 
DESCRIPTION, contain data of type String. The third column, 
IMAGE—RESOURCE—ID, contains data of type int. 


Suppose you wanted to get the value of the NAME column for the 
current record. NAME is the first column in the cursor, and contains 
String values. You’d therefore get the contents of the NAME 
column using the getString () method like this: 


Column 0 

V 

Column 1 

t 

Column Z 

nA 



IMAGE- 

NAME 

DESCRIPTION 

RESOURCE. 



ID 

“Latte” 

"Espresso and 
steamed milk" 

54543543 


String name = cursor.getString (0) ; 4 ： -TWis is 'm du\rsov. 


Similarly, suppose you wanted to get the contents of the 
IMAGE_RESOURGE_ID column. This is the third column in the 
cursor, and contains int values, so you’d use the code: 

int imageResource = cursor.getlnt(2); 

Finally, close the cursor and database 

Once you’ve finished retrieving values from the cursor, you need to 
close the cursor and the database in order to release their resources. 
You do this by calling the cursor and database close () methods: 

cursor.close(); 
db.close(); 

We’ve now covered all the code we need to replace the code in 
DrinkActivity so that it gets its data from the Starbuzz database. 
Let’s look at the code. 


You -Pihd details o-P all the 

methods m hUj> ： //dcvdopcv.ahdv-oid.^/ 
\rc+C\rCh^/ahd\roid/databasc/Cuv-so^.hUl. 
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DrinkActivity code 


The PriwkActivity code 

Here’s the full code for DrinkActivity.java (apply the changes in bold to 
your code, then save your work): 




DrinkActivity 

DrinkCategoryActivity 

Favorites 


package com.hfad.starbuzz; 


import 

import 

import 

import 

import 

import 

import 

import 

import 


android.app.Activity; 
android.os.Bundle; 



1/VcVc us'm^ -these c%*tva 

classes \ y \ 乙 ode. 


android.widget. 工 mageView; 
android.widget.TextView; 

android.widget.Toast; 
android.database.Cursor 
android.database.sqlite.SQLiteDatabase; 
android.database.sqlite.SQLiteException; 
android.database.sqlite.SQLiteOpenHelper; 




app/sre/main 

L [I3 



java 


com. hfad. starbuzz 

山 “ F»o{l 

O 

DrinkActivity.java 


public class DrinkActivity extends Activity { 


public static final String EXTRA—DRINKNO = "drinkNo"; 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 


setContentView(R.layout.activity—drink); 


//Get the drink from the intent 


This is -the ID o( ihc 
d\rmk ihc usev- (Most- 




int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 


//Create a cursor 


try { 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 


SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 


Cursor cursor 

t 


db.query ( M DRINK", 
new String[] {"NAME 


"DESCRIPTION", "IMAGE RESOURCE ID n }, 


Creaic a duv-sov- 七 Ka 七 yb ihe 

PKCRIPTION, a^d IMA^ 
R6S0URC£___IP -fvom PRIN^ 

-table id dv*nr>kNo- 


，▼一 id = ?，▼, 

new String[] {Integer.toString(drinkNo)}, 
null, null,null); 


Tlic Code 

oy \ -the 
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The PriwkActivity code (continued) 


□ 


Starbuzz 


//Move to the first record in the Cursor 



if (cursor.moveToFirst()) { ohly o^e Ytto^d ih the duvsov, 

but v/c still heed "to I^ovc "fco it. 

丁 he harnc o-f //Get the drink details from the cursor 

dv-ihk is the -fiv-st ’String nameText = cursor.getstring(0); 
ih "tKc du\rso\r 


the dcsdv-iptioh 
is the sedohd 

乙 olur»m, the 

\rcsouv-dc 
ID is the third. 
Thais because we 
"told the ^u\rso\r 
io use -the 
descript 陳， 

舶 d 嶋£一 

KBSOURCBJD 

dolur^hs -p\rorw the 

database \v\ that 

ovdev-. 


L n 

app/sre/main 


String descriptionText = cursor.getstring(1); 
int photold = cursor.getlnt(2); 

TextView name = (TextView)findViewByld(R.id.name); 

name.setText(nameText); 


□ 

java 

L [l 

com. hfad. starbuzz 

f#T (1 

Id 

DrinkActivity.java 



Use da*t3 f \row> *tV^c duV"SoV" 
■to po\>ula*tc *tV)C views. 


// Populate the drink description 
TextView description = (TextView)findViewByld(R.id.description); 

description.setText(descriptionText); 


// Populate the drink image 

工 mageView photo = ( 工 mageView)findViewByld(R.id.photo); 

photo.setlmageResource(photold); 
photo.setContentDescription(nameText); 



cursor.close();^ 

.^_ —^* Close -the duv-so\r database- 


db.close () 
catch(SQLiteException e) { 

Toast toast = Toast.makeText(this t "Database unavailable " t Toast.LENGTH SHORT); 


toast.show(); 




a is throyrn, 七 his mcaias ihtrts a f'roblcm Wrth 七 he 

database. I 朽七 his case, wc II use a Toast bo display a message b> tKc user. 


So that’s the DrinkActivity code complete. Let’s see 
what’s next. 


f^elax 


Connecting your 
activities to a database 
takes more code than 
using a Java class. 


But if you take your time working through 
the code in this chapter, you’ll be fine. 
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where we are 


What wg'vg done so far 

Now that we’ve finished updating the DrinkActivity.java code, let’s 
look at the app structure diagram to see what we’ve done, and 
what we need to do next. 



DrinkActivity 

DrinkCategoryActivity 

Favorites 






activity—top—level.xml 


匕七 iv/iiy 

still gets its dv’mk 
data -Pv-om -the Dv-'mk 
dlass. 


Drink.java 


Device 


TopLevel Activity .java 


DrinkCategoryActivity.java 


DrinkActivity now gets all of its drink data from the 
Starbuzz database. Next, we need to update the code in 
DrinkCategoryActivity so that it uses data from 
the database rather than from the Java Drink class. 


Starbuzz 

database 


activity—drink.xml 


SQLite Helper 


DrinkActivity.java 

亇 

bccir> so 

•rt i*U da*ta 

-pv-om 七 he S*ta\rbuz 
database via 七 he 
£6^L*rtc hclfcv-. 



Dumb Quest? 


9ns 


How much SQL do I need to know to create cursors? 


It's useful to have an understanding of SQL SELECT 
statements, as behind the scenes the query () method 
translates to one. In general, your queries probably won’t be too 
complex, but SQL knowledge is a useful skill. 


You said that if the database can’t be accessed, a 
SQLiteException is thrown. How should I deal with it? 

First, check the exception details. The exception might be 
caused by an error in SQL syntax which you can then rectify. 

How you handle the exception depends on the impact it has 
on your app. As an example, if you can get read access to the 
database but can’t write to it, you can still give the user read-only 
access to the database, but you might want to tell the user that you 
can’t save their changes. Ultimately, it all depends on your app. 
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The current PrmkCategoryActivity code 



cursors and asynctasks 

DrinkActivity 
DrinkCategoryActivity 
Favorites 


Here’s a reminder of what the current DrinkCategoryActivity.java code looks 
like. The onCreate () method populates a ListView with drinks using 
an ArrayAdapter. The onListl temClick () method adds the drink 
the user selects to an intent, and then starts DrinkActivity: 



Latte 

Cappuccino 


displays a lis-t o-f dv-mb. 


package com.hfad.starbuzz; 


Filter 


import 

import 

import 

import 

import 

import 


android.app.ListActivity; 

android.os.Bundle; 

android.widget.ArrayAdapter; 

android.widget.ListView; 

android.view.View; 

android.content.Intent; 




Starbuzz 



app/sre/main 


□ 


public class DrinkCategoryActivity extends ListActivity { 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


java 


com. hfad. starbuzz 


山 " f«T{1 

a 


DrinkCategory 

Activity.java 


super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 

ArrayAdapter<Drink> listAdapter = new ArrayAdapter<Drink>( 
this, 

android.R.layout.simple_list—item_l. 

Drink.drinks); f 一 

listDrinks.setAdapter(listAdapter); J 

} ^ 

QOverride 

public void onListltemClick(ListView listView, 

View itemView, 
int position, 
long id) { 

Intent intent = new 工 ntent(DrinkCategoryActivity•this, DrinkActivity.class); 
intent•putExtra(DrinkActivity•EXTRA—DRINKNO, (int)id); 
startActivity(intent); 


七七 k moment us*m^ 

a 的 AvvayAdaftcv- bo bmd a 於 

av-vay *to -the LisWiow- Wc 
Y\ttd *to v-cpladc this toAt so 
七 ha 七七 he daia tomes -fvom a 
database ms 七 ead. 
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cursor adapters 


How do we replace the array data 
iw the ListView? 


\/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


The listDrinks list view gets its data from the Drink. drinks 
array. Now, what we could do is read the list of drinks from the 
database, and then store them in an array that we pass to the array 
adapter. 


That would work, but can you think of a reason why that might be a 


bad idea? 


IVe 匕 ould just \rcad -the daia -Pv-om the 
dd'tdbdsc s-fco\rc diy\ avvay. 


T\)tY\ wc dould keep arvay adaf*tcv 
d^d vcs*t dodc y/ould be 

七 he same- Bu*t is 七 IVis a ^ood idea? 

i4 


Database 

data 


Array 




Array 

Adapter 


ListView 


0 


For our very small database, there’s no real problem in reading all of 
the data from the database and storing it in an array in memory. But if 
you have an app that stores a very large amount of data, then it’s going 
to take some time to read it all out of the database. It may also take a 
lot of memory to store it all in an array some place. 

Instead, we’re going to switch from using an ArrayAdapter to a 

CursorAdapter. 


Database 

data 


> 


Cursor 



ListView 

0 


A CursorAdapter is just like an ArrayAdapter, except instead 
of getting its data from an array, it reads the data from a cursor. 

Let’s look at how it works. 


OuV* dd'td is'm 七 he -fovm o-r 3 duv-sov, 
so y/e use a CuvsovAdaf*tcv- *to 
'rt m*to *tV>C 
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cursors and asynctasks 


A CursorAdaptcr reads just enough data 

Let’s pretend that our database is a lot larger. For example, let’s say 
Starbuzz massively extended its range of artisan coffees for the hipster 
market. Instead of three types of coffee, the different combinations of 
extra shots, milk, and granola sprinkles might mean that we need to store 
300 drinks in the database. But we can only see a few at a time in the list. 

The ListView can only display a limited number of items at one time. 
On a small device, it might only initially show, say, the first 11 coffees. If 
we were using an array, we would have to read all 300 coffees from the 
database into the array before we could display any on the screen. 

That’s not how it works with a Curs or Adapter. 



The ListView gets displayed on the screen. 

When the list is first displayed, it will be sized to fit the screen. Let’s say it 
has space to show five items. 



These a\rc the i-tems 
the Listl/icw has 


spade -to display. 1/VcVc 
usihg -five -to keep 
ihihgs simple, bu£ m 


it s likely -to 

be mo\rc. 




ListView 


The ListView asks its adapter for the first five items. 

The ListView doesn’t know where the data is coming from — whether it’s 
an array or a database — but it does know that it will be given the data by its 
adapter. So it makes a request to the adapter for the first five drinks. 



ListView Cursor* Adapter 
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what happens 


The story continues 


\/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 



The Cursor Adapter asks its cursor to read five rows from the database. 

A Cursor Adapter is given a cursor when it’s constructed, and it will ask the cursor for 
data only when it needs it. 



Even though the database table contains 300 rows, the cursor only needs to read the first five. 
That’s a lot more efficient, and it means that the screen can start displaying data much sooner. 




The user scrolls the list. 

As the user scrolls the list, the Curs or Adapter asks the cursor to read a few more 
rows from the database. If the user scrolls the list just a little, and uncovers one new 
item, the cursor will read one more row from the database. 



/\s i\\t user sd\rolls 

L'isWicv/, 

so more data is 



ListView 


CursorAdapter 




Database 


So a Curs or Adapter is a lot more efficient than the ArrayAdapter. It 
only reads the data it needs. That means it’s faster and takes up less memory, 
and speed and memory are both important things to keep in mind. 
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cursors and asynctasks 


A SimpleCursorAdapter maps data to views 


We’re going to create a simple cursor adapter to use 
with our app. A SimpleCursorAdapter is an 
implementation of Curs or Adapter that can be used in 
most cases where you need to display cursor data in a list 
view. It takes columns from a cursor, and maps them to 
TextViews or ImageViews. 

In our case, we want to display a list of drink names in 
our DrinkCategoryActivity list view, so we’ll use a 
simple cursor adapter to map the name of each drink to a 



ZX 


text view in the list view: 


Latte 

Cappuccino 

Filter 



Ouv Lis*t\/ic>w displays 
eadii dhrmk m 3 




android.widget. 

SimpleCursorAdapter 


Av*v-ayAd3f*t^v- 
Cuv-sovAdap*tcv- av-c 
bo*th -types of Adaftcv-. 
S*imflcCuv-sovAdaf*tcv- 
•is a subdlass of 
Cuv-sovAdaf*tcv-. 


First create the cursor 

The first thing to think about when creating a cursor to use with a cursor 
adapter is what columns the cursor needs to contain. The cursor should 
include all the columns that need to be displayed in the list view, along 
with a column called _id. The _id column must be included, or the cursor 
adapter won’t work. So why’s that? 

In Chapter 11, we mentioned that it was an Android convention to give 
the primary key column in a table the name _id. This is so integral to 
Android that the cursor adapter assumes that this column will be there, and uses it 
to uniquely identify each row in the cursor. When you use a cursor adapter 
with a list view, the list view uses this column to identify which row the user 
has clicked. 


As we’re using a cursor adapter to display the names of the drinks, our 
cursor must contain the _id and NAME columns like this: 

cursor = db.query("DRINK", new String[]{’ ▼ 一 id n , "NAME"}, 

null, null, null, null, null); 


rwus-t mdude "the」d 
^olurw^ -though wcVc 
⑽七 displaymj its data. 


On the next page, we’ll use the cursor to create the cursor adapter. 
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SimpleCursorAdapter 


Creating the SimpleCursorAdapter 

To create a simple cursor adapter, you need to tell it how you want the data 
to be displayed, which cursor to use, and which columns should be mapped 
to which views. Here’s how you’d create a simple cursor adapter to display a 
list of drink names: 


\/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


This IS duv-sov -fvom -the pvcvious 


cursor = db.query( n DRINK", new String[]{"_id M , "NAME "}, 

null, null, null, null, null); 

CursorAdapter listAdapter = new SimpleCursorAdapter(this, 

android. R. layout .simple 一 list—item 一 This is 七 he sa^e layout wc used wiih 

cursor, 

new String[]{"NAME"}, ^ - 

new int [] {android.R. id. textl}, Display *tKc dor>*tcy>*ts o( MAMB- 

0) ； t . 


This is 七 he duvsov. 


七 he 

value 


a\rray adap-tev-. H displays a s’mgle 

: -rov- cadh \rov/ *m 七 he list view. 


dolumv> *m *tiic UsiV'ievj 七作七 
listDrinks. setAdapter (listAdapter) ; <r-Usc sciAdaptcrO h> Co^tti the adaplcv io the list vi 


View. 


Just as we did with the array adapter, we’re using android. R. layout. 
simple_list_item— 1 to tell Android that we want to display each row 
in the cursor as a single text view in the list view. This text view has an ID of 
android.R.id.textl. 

The general form of the SimpleCursorAdapter constructor looks like 
this: 


Wo^j *to display i\\t data- You 
ddy> use *thc same layout you 
used v/rth 扣 av-vay adaf 毛 cv*. 


SimpleCursorAdapter adapter = new SimpleCursorAdapter(Context context, 

int layout. 

The £.uv*so\r you d\rca"tc. ~^Cursor cursor. 



The du\rso\r should mdude 
"the __id dolurw^ -the 
data you -to appear. 

The context and layout parameters are exactly the same ones you used 
when you created an array adapter, context is the current context, and 
layout says how you want to display the data. Instead of saying which array 
we need to get our data from, we need to specify which cursor contains the 
data using the cursor parameter. You then use fromColumns to specify 
which columns in the cursor you want to use, and toViews to say which 
views you want to display them in. 

The flags parameter is generally set to 0, which is the default. The 
alternative is to set it to FLAG REGISTER CONTENT OBSERVER to 
register a content observer that will be notified when the content changes. 
We’re not covering this here, as it can lead to memory leaks. Later in the 
chapter, you’ll see how to deal with the underlying data changing. 


String[] fromColumns, 

±nt[] tOVieWS '^/__ 


int flags) 


Used *to 

七 lie bcKaviov 
o( 七 he tuvsov. 


i 妁 "tKc £.u\rso\r *to 

"fco y/hidh 

views 
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Closing the cursor and database 


When we introduced you to cursors earlier in the chapter, we 
said that you needed to close the cursor and database after 
you’d finished with it in order to release their resources. In our 
DrinkActivity code, we used a cursor to retrieve drink details 
from the database, and once we’d used these values with our views, 
we immediately closed the cursor and database. 


When you use a cursor adapter, it works slightly differently; the 
cursor adapter needs the cursor to stay open in case it needs to 
retrieve more data from it. This will happen if the user scrolls 


down the list of items in the list view, and needs to see more data 



ListView 



CursorAdapter 


This means that you can’t immediately close the cursor and 
database once you’ve used the setAdapter () method to 


you dlosc the ^uv-sov- 
*fc°° sooh, the ^uv-sov- 
adaptev- woh ; -t be able 
■to r^oirc daia -Pv-o^ 

the ^u\rso\r. 


connect it to your list view. Instead, you can use the activity’s 
onDestroy () method to close them. As the activity’s being 
destroyed, there’s no further need for the cursor or database 
connection, so they can be closed: 


public void onDestroy(){ 
super.onDestroy(); 
cursor.close(); 

db.close() ; 〈 Close 七 he duv*sov 扣 d d3*t3ib3sc 

1 *tv>c attivi-ty IS dtsbro^td- 


On the next page, see if you can update the code for 
DrinkCategoryActivity. 
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exercise 



Paa] Puzzjc 


Your job is to take code segments from the 
pool and place them into the blank lines 
in DrinkCategoryActivity.java. You may 
not use the same code segment more 
than once, and you won’t need to use 
all the code segments. Your goal is 
to populate the ListView with a list of 
drinks from the database. 


public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db; 
private Cursor cursor; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 

try { 

starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
db = StarbuzzDatabaseHelper. ; 

The toAt oy \ 七 he 灼 wt PdAe 一 ^ 

Note: each thing from 



□ 

Starbuzz 

LQ 

app/src/main 

L a 

java 


□ 
com.hfad.starbuzz 

a 

DrinkCategory 

Activity.java 
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cursor = db•query( n DRINK n , 

new String[] { }, 

null, null, null, null, null); 

CursorAdapter listAdapter = new (this, 

android.R.layout.simple—list 一 item_l, 


new 
new 
0)； 

listDrinks.setAdapter(listAdapter); 

} catch( e) { 

Toast toast = Toast.makeText(this, 
toast.show(); 


@0verride 

public void onDestroy(){ 
super.onDestroy(); 

.close (); 

.close (); 

} 

QOverride 

public void onListltemClick(ListView listView 

View itemView, 


String[]{.}, 

int[]{android.R.id.textl }, 


Database unavailable，'，Toast • LENGTH—SHORT) 


□ 

Starbuzz 



app/src/main 

L D 


com. hfad. starbuzz 

f«T{| 

Id 

DrinkCategory 

Activity.java 




int position, 
long id) { 

Intent intent = new 工 ntent(DrinkCategoryActivity•this, DrinkActivity.class); 
intent•putExtra(DrinkActivity•EXTRA—DRINKNO, (int) id); 
startActivity(intent); 
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solution 



Paa] puzzjc §a]ufian 

Your job is to take code segments from the 
pool and place them into the blank lines 
in DrinkCategoryActivity.java. You may 
not use the same code segment more 
than once, and you won’t need to use 
all the code segments. Your goal is 
to populate the ListView with a list of 
drinks from the database. 


public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db; 
private Cursor cursor; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 

/ You yt a *to da*tabasc 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this); 
db — starbuzzDatabaseHelper. getReadableDatabase ()； 



□ 

Starbuzz 

LQ 

app/src/main 

L a 

java 


□ 
com.hfad.starbuzz 

a 

DrinkCategory 

Activity.java 
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TV^c tyArsor must mdudc Jd Co\^, or 仏 c 
adapts y/o^t work. It must also \uWAt tV^c 剩 & 
co\^ so ^ ca^ d 啤 ㈣ a Id d drnk ^amcs. 

cursor = db • query ( n DRINK ，'， ^ 

new String [] { :: 獲 :: .}, 

null, null, null, null, null); 

^ c，v " c “si% a SirwpIcCuv-sov-Adapicv-. 

Curs or Adapter listAdapter = new SimpleCursor Adapter (this, 

android.R.layout.simple—list—item—l, 

[cursor , ^ - - pisflay {\\t 乙 cmterrU 

new String [] { "NAME" }, NMl 它 to l_ … 

new int[]{android•R•id•textl}, 

0)； 

listDrinks.setAdapter(listAdapter); 

l*P 七 he database is unavailable, well da-Uh -the ^L\icB%tcyho^ 


Use *tV)C duv-so\r wc jus 七 treated. 



} catch ( SQLiteException e) { 

Toast toast = Toast.makeText(this, "Database unavailable ", Toast•LENGTH—SHORT) 
toast.show(); 


□ 


Starbuzz 


@Override 

public void onDestroy(){ 
super.onDestroy(); 

•wr.?.??!..... close () ; Close tuv-sov- bc-fo\rc you 


L d 

app/sre/main 

"lb 


java 


db 


.close (); ^ / tlosc 



com. hfad. starbuzz 

} I <uu F*Tn 

J r “u … I 

DrinkCategory 

@ Override Activity.java 

public void onListltemClick(ListView listView, 

View itemView, 
int position, 
long id) { 

Intent intent = new 工 ntent(DrinkCategoryActivity•this, DrinkActivity.class); 
intent•putExtra(DrinkActivity•EXTRA—DRINKNO, (int)id); 
startActivity(intent); 

} 
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DrinkCategoryActivity code 


The revised code for PrmkCategoryActivity 

Here’s the full code for DrinkCategoryActivity.java ， replacing the 
array adapter with a cursor adapter (the changes are in bold): 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


package com.hfad.starbuzz; 


□ 

Starbuzz 


import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 


android.app.ListActivity; 
android.content.Intent; 
android.os.Bundle; 


app/sre/main 



android.view.View; 
android.widget.ListView; 

android.database.Cursor; - 、 

android.database.sqlite.SQLiteDatabase; 
android.database.sqlite.SQLiteException; 
android.database.sqlite.SQLiteOpenHelper 
android.widget.CursorAdapter; 
android.widget.SimpleCursorAdapter; 
android.widget.Toast; 

android.widget.SimpleCursorAdapter; # 


java 


com. hfad. starbuzz 

Id 


DrinkCategory 

Activity.java 


iVeYe usmg -these classes ； 
so you b> irwpo\rt "therw. 


public class DrinkCategoryActivity extends ListActivity { 

private SQLiteDatabase db^ 

private Cursor cursor; as Private vahables so we 6 

如 databasi a”d tuv-sov- m ouv o^PcstroyO 

@Override 


protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 

ListView listDrinks = getListView(); 


try { 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
db = StarbuzzDatabaseHelper.getReadableDatabase(); 

cursor = db.query("DRINK", 

new String[]{’ ▼ 一 id n , "NAME"}, 
null, null, null, null, null); 


b> 七 he ddiabase. 


Cvcsie -the duvsov. 


The toAt 匕 oirt’mues on 七 he 灼 e 火 t page. 
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The PriwkCatGgoryActivity code (continued) ada ― 




CursorAdapter listAdapter = new SimpleCursorAdapter(this, 

android.R.layout.simple_list—item_l, 
cursor, 

Ma P the oUk MAMB nGW String []{ ™- } , 

dolumy> -to ihc it%i *m LisW.cy/. 二 ^new int[] {android.R. id. textl}, 

0)； 

listDrinks • setAdapter (listAdapter) ; (- IA/cVc still usi^ ^ adaftc^ bui 
catch (SQLiteException e) { "this -time i^s a du\rso\r adap'tcv-. 

Toast toast = Toast.makeText(this, "Database unavailable", Toast•LENGTH 一 SHORT) 

Display a message *to *tV>c usev i-f a 
S^L"i*tc£%tcftior> 七 V>vo 她 • 


toast.show(); 


CjI 


Starbuzz 


@Override 


public void onDestroy () { ^^ 代 dlosmj "the dd'tdbdse and £.u\rso\r *m 七 he 
super.onDestroy() ; —Wi 切 ’s o^Dcs^oyO method- The 


L u 

app/sre/main 

L a 

java 


cursor.close(); 
db.close(); 


will s-tay open ujrrtil 七 he ^uv-sov- dddfiev- y\o 
lo^jc\r i^eeds i-t. 



com. hfad. starbuzz 

Id 

DrinkCategory 

Activity.java 


^ 一 .\Nt didn't *to 

dha 哼 *th"is method- 


QOverride 

public void onListltemClick(ListView listView J 

View itemView, 
int position, 
long id) { 

Intent intent = new 工 ntent(DrinkCategoryActivity•this, DrinkActivity.class); 
intent•putExtra(DrinkActivity•EXTRA—DRINKNO, (int)id); 
startActivity(intent); 

} 


Let’s try running the app. 
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test drive 

K 


Test drive the app 




DrinkActivity 

DrinkCategoryActivity 

Favorites 


Make the changes to the code, and then build and redeploy the app. 
When you do that, you’ll see that the app looks exactly the same as before. 


10:26 




Drinks 


Food 


Stores 


Latte 
Cappuccino 
Filter 




But now the data is being read from the database. In fact, you 
can now delete the Drink.java code, because we no longer 
need the array of drinks. Every piece of data we need is now 
comine from the database. 



Where we've got to 

Here’s the current state of the Starbuzz app: 



activity—top—level.xml 




Starbuzz 

database 


<Layoul> 

H| 

</Layout> I 


SQLite Helper 


activity—drink.xml 



Device 


TopLevelActivity.java 


DrinkCategoryActivity.java 



DrinkActivity.java 


There’s one more change we’re going to make to the app. 
We’re going to get the app to update data in the database. 


-the a^iiviiics 七 ha*t 
dddess -the dldss so 七七 hey 
use 七 he database mstcad- 
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Put important mformatiow iw the top-level activity 

When we first created our Starbuzz app, we designed the top-level 
activity to be very simple. The top-level activity is the first activity that 
the user sees when they launch your app, and all the Starbuzz one 
contains is an image and three navigation items which could be moved 
into a navigation drawer. It’s a good idea to keep your user interface 
simple, but is this too simple? 

The design of your top-level activity needs careful thought, as it’s the 
first thing that your user sees. Ideally, it should contain content that’s 
useful for new and existing users. One way of achieving this is to think 
about what your users will want to do in your app, and then give them 
a means of doing this from the front screen. As an example, if you 
were designing an app to play music, you might want to include the 
most recent albums the user has played in the top-level activity so that 
they’re easy for the user to find. 


We’re going to change the Starbuzz top-level activity by adding the 
users favorite drinks to it, and allowing them to click straight through to 
the drink they select. 


TKcsc ideally 

bcloir>^ m d 朽 

dva>wcv-. 1 /VlcVc 
o^omj *fco ddd d 

dv-av/cv* *to 



16:27 




七 he Stav-buzz. app, as 
y>dVl^d*b'lOir> dv-a>WCV 
CoAt is a brt mvolvcd 
av\d v/air^t you *bo 
•fodus on d3"tolb3scs. 


Well ddd d LlS"t\/iCV/ 
"to TopLcvdA^iiviiy, 
v/hidh dorrta’ms -the 
iaSC\t’s -Pavo\riic d\r*mks. 



To do this, we first need to allow users to say which drinks are 
their favorites. 
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Add favorites to PriwkActivity 

In Chapter 11, we added a FAVORITE column to the DRINK table 
in the Starbuzz database. We’ll use this column to let users indicate 
whether a particular drink is one of their favorites so that we know 
which drinks to display in TopLevelActivity. We’ll let users 
edit drinks within DrinkActivity, as this activity displays details 
of the drink. 

To do this, we need to add a new view to activity—drink.xml that will be 
used to edit and display the value of the FAVORITE column. The 
type of view you use in a layout depends on what type of data you 
need to use it for. We need a view that will allow the user to choose 
true/false values, so we’re going to use a checkbox. 

First, add a String resource called favorite to strings.xml (we’ll use 
this as a label for the checkbox): 


<s tring name=，▼ favorite" >Favorite</string> 

Then add the checkbox to activity—drink.xml. We’re giving it an ID 
of favorite, and using its android : text attribute to display 
its label. We’re also setting its android: onClick attribute to 
"onFavoriteGlicked" so that the onFavoriteClicked () method in 
DrinkActivity will be called when the user clicks on the checkbox. 


V 

v/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 



<LinearLayout ...> 

<ImageView android : id="@+id/photo 

... /> 


V T 


<TextView android : id= M @+id/name 

... /> 




hcsc av-c *thc Y\di^t, 
dr>d dcsdv'iftio^ vicv/s 
y/e added >wc *f*ivs*t 
dv-ca*tcd i\\t ad 七 W’i 七 y 


^ - 2 

LJ 

Starbuzz 

□ 

app/src/main 



res 


<TextView android : id="@+id/description' 

... /> 

<CheckBox android : id= M @+id/favorite M 

android : layout_width= n wrap—content" 
android : layout_height= n wrap—content' 
android : text="@ string/favorite n 


layout 




V^as IP favorite. 


activity_drink.xml 


l/Ve io jive -the a label- 


</LinearLayout> 


android : onClick= n onFavoriteClicked" /> W\\CY\ «s disked ) 七 

o^or\itC\\ektdO y/»ll yt died. 
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Add a new column to the cursor 

The next thing is to change the DrinkActivity code so that the 
favorite checkbox displays the value of the FAVORITE column 
that’s in the database. 

We can retrieve the value of the FAVORITE column in the same 
way that we did for the other views in the activity, by adding the 
FAVORITE column to our cursor. We can then retrieve the value 
of the FAVORITE column from the cursor, and set the value 
of the checkbox to that value. Here’s the relevant part of the 
onCreate () method: 

protected void onCreate(Bundle savedlnstanceState) { 

• •參 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 

Cursor cursor = db.query ( n DRINK n , 

new String [] { "NAME", "DESCRIPTION ， ' ， ， ▼ 工 MAGE 

n _id = ? n , 

new String[] {Integer•toString(drinkNo) }, 

null, null,null); 

/ /Move to the first record in the Cursor 
if (cursor.moveToFirst() ) { 

//Get the drink details from the cursor 
String nameText = cursor.getString(0); 

String descriptionText = cursor.getString(1); 

int photold = cursor.getlnt(2); 6\c{, value o( FAVORITE 

boolean is Favorite = (cursor. getlnt (3) == 1) ; dolumyv s*tovcd m 七 he da*tabasc 

as I -fov *tvuc, 0 (or -false- 

• 參* 

//Populate the favorite checkbox 

CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 
favorite.setChecked(isFavorite); 


That’s enough to make sure the value of the FAVORITE column 
is displayed in the checkbox. Next, we need to get the checkbox to 
update the database when it’s clicked. 


Set value o( -the 

-favovi-tc dhe 匕 kbo 乂 . 


RESOURCE ID 1 


FAVORITE"}, 


Md Ihc FfiVORlTB 

匕 olunrm "to -the du\rso\r. 





Starbuzz 


app/sre/main 

■ r~ 2 
-|__j 


java 



com. hfad. starbuzz 

O 

DrinkActivity.java 
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respond to clicks 


DrinkActivity 
DrinkCategoryActivity 
Favorites 

When we added the checkbox to activity—drink.xml ， we set the 
android : onClick attribute to onFavoriteClicked ( ). 

This means that whenever the checkbox is clicked, the 
onFavoriteClicked () method in the activity will get called. 

We need to get this method to update the database with the current 
value of the checkbox. If the user checks or unchecks the checkbox, 
the onFavoriteClicked () method will get called and the user’s 
change will be saved to the database. 

In Chapter 11, you saw how to use SQLiteDatabase methods to 
change the data held in a SQLite database. You saw how to use the 
insert ( ) method to insert data, the delete () method to delete 
data, and the update () method to update existing records. 

You can use these methods to change data from within your activity. 

As an example, you could use the insert () method to add new 
drink records to the DRINK table, or the delete () method to 
delete them. In our case, we want to update the DRINK table’s 
FAVORITE column with the value of the checkbox, and we can do 
this using the update () method. 

As a reminder, the update () method takes the following form: 

database.update(String table, 

ContentValues values. 

String whereClause, 

String[] whereArgs); 

where table is the name of the table you want to update, and 
values is a ContentValues object containing name/value pairs 
of the columns you want to update and the values you want to set 
them to. The whereClause and whereArgs parameters specify 
which records you want to update 

You already know everything you need to get DrinkActivity 
to update the FAVORITE column for the current drink when the 
checkbox is clicked, so have a go at the following exercise. 


Respond to clicks to update the database 


v 

v/ 



DrinkActivity 



Starbuzz 

database 
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Cocte Magnets 

In our code for DrinkActivity we want to update the FAVORITE 
column in the database with the value of the favorite checkbox. Can 
you construct the onFavoriteClicked () method so that it will 
do that? 


public class 

• 參 

/ /Update 


DrinkActivity extends 


the database when the 


Activity { 


checkbox is clicked 


public void onFavoriteClicked( 



int drinkNo = ( 工 nteger)getlntent () •getExtras () •get(EXTRA—DRINKNO); 
CheckBox favorite = (CheckBox)findViewByld(R•id.favorite); 


drinkValues = new 


drinkValues.put( , favorite.isChecked()); 


SQLiteOpenHelper starbuz zDatabaseHelper = 

new StarbuzzDatabaseHelper(DrinkActivity.this); 


try { 


SQLiteDatabase db = starbuzzDatabaseHelper. 


db.update( 


,new String[] {Integer•toString(drinkNo)}); 

db.close (); 


} catch(SQLiteException e) { 

Toast toast = Toast•makeText(this, "Database unavailable ，'， Toast•LENGTH—SHORT); 
toast.show(); 
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magnets solution 



Code Magnets Solution 


v 

v/ 


In our code for DrinkActivity we want to update the FAVORITE 
column in the database with the value of the favorite checkbox. Can 
you construct the onFavoriteClicked () method so that it will 
do that? 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


public class 

• • 

/ /Update 


DrinkActivity extends 


the database when the 


Activity { 


checkbox is clicked 



public void onFavoriteClicked( 


){ 


int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 
CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 




favorite.isChecked()) 


SQLiteOpenHelper starbuzzDatabaseHelper 二 

new StarbuzzDatabaseHelper(DrinkActivity.this); 


try { 


SQLiteDatabase db = starbuzzDatabaseHelper. 5 e tWritableDatabase() I ； 

_ k - - — 1 

db. update ( "DRINK" | r drinkValues || f Wc t\ttA v*cad/addcss *to 

-the database -to update *i*t- 

n _id = ? M I ， new String[] {Integer•toString(drinkNo)}); 

db.close (); 

} catch(SQLiteException e) { 

Toast toast = Toast.makeText(this, "Database unavailable ，'， Toast•LENGTH—SHORT); 
toast.show(); 


Vo[a dicW 七 t\ttd bo use 




■these 



favorite 
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cursors and asynctasks 


The PriwkActivity code 


Here’s the full code for DrinkActivity.java (changes are in bold): 


package com.hfad.starbuzz; 

import android.app.Activity; 
import android.os.Bundle; 
import android.widget. 工 mageView; 
import android.widget.TextView; 
import android.widget.Toast; 
import android•database•Cursor; 
import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteException; 
import android. database . sqlite . SQLiteOpenHelpere¬ 
import android.view.View; 


sP 


uzz 



app/sre/main 


java 



com. hfad. starbuzz 

a 

DrinkActivity.java 


import android.widget.CheckBox; 
import android.content.ContentValues 〆 



WleVc us'm^ 七 hesc dlasscs. 


public class DrinkActivity extends Activity { 


public static final String EXTRA—DRINKNO = "drinkNo"; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity 一 drink); 


//Get the drink from the intent 

int drinkNo = ( 工 nteger)getlntent () •getExtras () •get(EXTRA—DRINKNO); 


// Create 
try { 


a cursor 


>u y>eed vead/v/v-*rtc atdess *to 
i\\t database b> ufdaic *i*t- 


SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this); 
SQLiteDatabase db = StarbuzzDatabaseHelper. getWritableDatabase(); 

Cursor cursor = db.query ("DRINK ", 

new String [ ] { "NAME", "DESCRIPTION ，'， ，▼工 MAGE RESOURCE ID ，'， "FAVORITE" }, 


id 


9 




new String[] {Integer•toString(drinkNo)}, 

null, null,null); 


Add ihc HVORITB 

doluimr> -fco -the du\rsov-. 


/ /Move to the first record in the Cursor 
if (cursor.moveToFirst()) { 


//Get the drink details from the cursor 
String nameText = cursor.getString(0); 

String descriptionText = cursor.getString(1) 
int photold = cursor•getlnt (2); 

boolean isFavorite = (cursor.getlnt(3) == 1) 

value O-f FA\/0R|TE dolurnir>. 


The toAt 
oy \ -the 
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DrinkActivity code 


The PriwkActivity code (continued) 


v 

v/ 


// Populate the drink name 

TextView name = (TextView)findViewByld(R.id•name); 
name.setText(nameText); 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


// Populate the drink description 

TextView description = (TextView)findViewByld(R.id.description); 
description.setText(descriptionText); 


// Populate the drink image 

工 mageView photo = ( 工 mageView)findViewByld(R.id.photo); 
photo.setlmageResource(photold); 
photo.setContentDescription(nameText); 


//Populate the favorite checkbox 

CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 
favorite.setChecked(isFavorite); 《 

} ； Pofulaic diicdkbo%. 

cursor.close(); 
db.close (); 

} catch(SQLiteException e) { 

Toast toast = Toast•makeText(this, "Database unavailable". Toast•LENGTH—SHORT); 
toast.show(); 


//Update the database when the checkbox is clicked 
public void onFavoriteClicked(View view){ 

int drinkNo = (Integer)getlntent().getExtras().get("drinkNo"); 

CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 

ContentValues drinkValues = new ContentValues(); » , , , p f r 

drinkValues • put (▼▼ FAVORITE’、favorite • isChecked0 ) f ⑹二，七 ! ^ C … 匕 kbo 乂 

SQLiteOpenHelper starbuzzDatabaseHelper = V to 如 d—s CohichH/alucs object 

new StarbuzzDatabaseHelper(DrinkActivity.this); 

try { 

Update the SQLiteDatabase db = starbuzzDatabaseHelper.getWritableDatabase(); 

FAVORITB '^db. update ("DRINK" , drinkValues , 


new String[] {Integer.toString(drinkNo)}); 


-fco -the n id = ? 

v^luc o-P "the db. close (); 

乙 hedkbo 乂 . } catch (SQLiteException e) { 

Toast toast = Toast.makeText(this, "Database unavailable", Toast•LENGTH—SHORT) 
toast.show(); 

} pisplay 3 message a pv-oblcm v/rth 七 he da*tabasc- 
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display favorites iw TopLevdActivity 

The final thing we need to do is display the user’s favorite drinks in 
TopLevelActivity. 


o 

O 

o 


We need to add a new List View to the layout. 

This will display a list of the user’s favorite drinks. 

We need to populate the ListView. 

We’ll populate the list with the user’s favorite drinks from the database. 

We need to get the ListView to respond to clicks. 

If the user clicks on one of their favorite drinks, we’ll display details of 
the drink in DrinkActivity. 


Applying all of these changes will enable us to display the user’s 
favorite drinks in TopLevel Activity. 


Starbuzz 

database 


The -favov'i*tcs L'is*t\/ic>w 
Will yt rb data -f V*om 七 he 
database us'm^ a duvsov. 

V 





Over the next few pages, we’ll go through the code to do this. 
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display favorites 


display the favorite driwks m 
activity_top_level.xml 

As we said on the previous page, we’re going to add a list view 
to activity_top_level.xml, which we’ll use to display a list of the 
user’s favorite drinks. We’ll also add a text view to display a 
heading for the list. 

First, add the following String resource to strings.xml (we’ll use 
this for the text view’s text): 

<string name="favorites">Your favorite drinks : </string> 

Next, update activity—top_level.xml to add the text view and list 
view like this: 

<LinearLayout ... > 


V 

v/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 



<ImageView 

android 

android 

android 

android 

<ListView 

android 

android 

android 

android 


layout_width= M 2 OOdp" 

layout_height="lOOdp" 

src=" @drawable/ starbuzz—logo，' 

contentDescription="@string/starbuzz logo" / > 


□ 


Starbuzz 




id 二 ，， @ + id/list_options ▼， 
layout_width= n match 一 parent，' 
layout_height= ，， wrap—content ’ 
entries = M @array/options" / > 


Tk layout already dohtaihs the 
S-b\rbui2. logo ay\d list view. 


app/sre/main 


res 


4U 

layout 




activity— 

〈TextView ^|| a Jd d view *to display topjevel.xml 

android: layout 一 width= n wrap 一 content” ^o\aY -favov*i*tc dv-mks w . Well 

android: layout 一 height= n wrap 一 content” 七 a s 七 〆 tailed -favovites. 

android : layout_marginTop="5 Odp M 

android : textAppearance= n ?android:attr/textAppearanceLarge n 
android : text= n @string/favorites n /> 


<ListView 

android : id= n @+id/list—favorites” ^ - 

android : layout_width="match_parent M 
android : layout_height= n wrap—content” /> 

</LinearLayout> 


The lisi_-favo\riics 
Lis-t\/icv/ v/ill 
display 七 he usev-^s 
-Pavov-i-tc dv-*mks. 


Those are all the changes we need to make to activity_top_ level, 
xml. Next, we need to update Top Lev elAc tivity.jav a. 
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What changes arc needed for 
TopLevd Activity .java 

The next thing we need to do is display the users favorite drinks 
in the list view we just added, and get the list view to respond to 
clicks. To do this, we need to do the following: 



We need to create a cursor to populate the ListView. 

The cursor will return all drinks where the FAVORITE column has 
been set to 1 — all drinks that the user has flagged as being a favorite. 
Just as we did in our code for DrinkCategoryActivity, we can 
connect the cursor to the ListView using a Curs or Adapter. 



Database 



We need to create an onltemClickListener so that the 
ListView can respond to clicks. 

If the user clicks on one of her favorite drinks, we can create an intent 
that starts DrinkActivity, passing it the ID of the drink that was 
clicked. This will show the user details of the drink they’ve just chosen. 



Intent 


drinkNo 


TopLevelActivity 



DrinkActivity 


You’ve already seen the code you need to do this, so over the 
next few pages, we’ll give you the full code for TopLevelActivity. 
java. 
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TopLevelActivity code 


DrinkActivity 
DrinkCategoryActivity 
Favorites 

Here’s the new code we need to add to Top Lev elActivity.jav a (there’s a lot 
of new code, so go through it carefully and take your time): 


The new top-level activity code 


\/ 

v/ 


package com.hfad.starbuzz; 


□ 

Starbuzz 


import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 


android.app.Activity; 
android.content.Intent; 
android.os.Bundle; 


android.widget.AdapterView; 
android.widget.ListView; 


android.view.View; .^ 

android.database.Cursor 
android.database.sqlite.SQLiteOpenHelper; 
android.database.sqlite.SQLiteException; 
android.database.sqlite.SQLiteDatabase; 
android.widget.SimpleCursorAdapter; 
android.widget.CursorAdapter; 
android.widget.Toast; 


iVcVc us'm^ dll *thcsc 
c%*tva dlasscs. 


L Q 

app/sre/main 

L D 


java 

L CHI 

Dm.hfad.st2 


com.maa.starbuzz 

■ tUu 

o 


TopLevel 

Activity.java 


public class TopLevelActivity extends Activity { 


private SQLiteDatabase db; < 一 ~ — IVfeVc addmj these as pv-ivalc variables so ihsi wc have 
private Cursor favoritesCursor , -fco "them \ y \ 七 he o 灼 Des 七 voyO method. 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_top—level); 
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The TopLevelActivity code (continued) 


// Create an OnltemClickListener for the Options ListView 
AdapterView•OnltemClickListener itemClickListener = 
new AdapterView•OnltemClickListener(){ 

public void onltemClick(AdapterView<?> listView, 

View v, 

int position, 

long id) { 


□ 


Starbuzz 


L Q 

app/src/main 

-^3 


java 


if (position == 0) 
Intent intent 


com. hfad. starbuzz 

«la*t F*«(I 
fUlii—■ 

new 工 ntent(TopLevelActivity•this, ' J 

TopLevel 

DrinkCategoryActivity. class) ; Activity java 

startActivity(intent); 


I 


This is toAt m ouv* 

} oXrcsieO method- \i populates i\\t options 

}； list viev/ ar\d iht list V*ic>w *to \rcsfoir>d *to 

dlidks. Wlc still y\ttd 七 his dodc. 

/ /Add the listener to the Options ListView ^ 

ListView listView = (ListView) findViewByld(R.id.list—options); 
listView.setOnltemClickListener(itemClickListener); 

i\\t -favoviics lis 七 viow. 

//Populate the list 一 favorites ListView from a cursor y: 

ListView listFavorites = (ListView)findViewById(R.id.list—favorites); 
try{ 

SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
db = starbuzzDatabaseHelper.getReadableDatabase(); 
favoritesCursor = db.query("DRINK", 


f 

Cv-catc a ^uv-sov- 

that 

values 

Jd av\d NAMB 

^olumhS 

FAl/ORlTE-l. 


gets the 

； o( the 


new String[] { ’ ▼ 一 id 
"FAVORITE = V\ 4 — 
null, null, null 


"NAME"}, 

… 七七 k of 

null) ; -favov-rtc dkmks. 


usevs 


The Code 

oy \ 七 he page. 
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code continued 


The TopLevelActivity code (continued) 


v 

v/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


new SimpleCursorAdapter(TopLeve1Activity.this, 


CursorAdapter favoriteAdapter = 

T 

Use the ^uvsov ih android. R. layout. simple list item 1, 

tnc duvsov adap-tev-. — — — 

favoritesCursor, 


p*. splay the new String[]{ "NAME"}, 

dv'mks m Lis*t\/iC>w- new int [] {android. R. id. textl }, 0); 


listFavorites.setAdapter(favoriteAdapter); 
catch(SQLiteException e) { 

Toast toast = Toast.makeText(this, "Database unavailable", Toast.LENGTH SHORT); 
toast.show (〉； 


Pi^lay a message \( 七 hevVs a pvoblcm W\{}\ database 


This will jci called i-f iiei 
m ihc lis-t view is dideed. 


//Navigate to DrinkActivity if a drink is clicked 
listFavorites.setOnltemClickListener(new AdapterView.OnltemClickListener() { 
©Override 

public void onltemClick(AdapterView<?> listView, View v, int position, long id) 


}) 


Intent intent = new Intent(TopLevelActivity.this, DrinkActivity.class); 
intent.putExtra(DrinkActivity.EXTRA—DRINKNO, (int)id); 
startActivity(intent); 个 

|-f i\\t usev C\\cks oy\ one ’rtems ’m i\\t 

-(•SVoV'i'tcs s*t3\r Starbuzz 

passmj alonj IP <A dmk. 


□ 


//Close the cursor and database in the onDestroy() method 
@Override 

public void onDestroy(){ 
super.onDestroy(); 

favoritesCursor. close () ; Close the ^uvsov- 3hd dd'tdbdse whch the 

db.closeO; is dcs^oyed. 


app/sre/main 



java 


匕口 


com.hfad.starbuzz 

f*T {1 

Id 

TopLevel 

Activity.java 


The above code populates a list view with the user’s favorite drinks. When the user 
clicks on one of these drinks, an intent starts DrinkActivity and passes it the ID 
of the drink. Details of the drink are then displayed. We’ll show you this running on 
the next page, along with a problem we need to sort out. 
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Test drive the app 


When we open the app, the new text view 
and new favorites list view are displayed in 
TopLevelActivity, as you’d expect. No drinks 
are displayed in the list view because no drinks 
have been chosen as favorites yet. 





Drinks 


16:09 



Food 

Stores 


The -Pavov-i-tcs List\/icv/ 
is hcv*c- H isr / 七 visible ； ds>~ 
y\o dv-mks m 


Your favorite drinks: 



When we navigate to DrinkActivity, a new 
checkbox is displayed. If we click on it, this flags 
that the drink is a favorite. 



ttcv-c's i\\t wc 

added- Ckk •… 3 1 七 

updates i\\t S*ta\rbuzi * — ^ 
database. 


_atte 

Espresso and steamed milk 

Favorite 



When we go back to TopLevelActivity, the drink we selected as 
a favorite isn’t displayed in the favorites list view. It only appears if we 
rotate the device. 





Why do you think the drink we chose as a favorite 
doesn’t appear in the list view until we rotate the 
screen? Think about this before turning the page. 


16:10 
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out of date data 


DrinkActivity 
DrinkCategoryActivity 
Favorites 

If the user chooses a new favorite drink by navigating through the app to 
DrinkActivity, the new favorite drink isn’t automatically displayed in 
the favorites list view in TopLevelActivity. This is because cursors 
retrieve data when the cursor gets created. In our case, the cursor is 
created in the activity onCreate () method, so it gets its data when the 
activity is created. When the user navigates through the other activities, 

TopLevelActivity is stopped, not destroyed and re-created. 


Cursors don't automatically refresh 


v 

v/ 



.atte 

Espresso and steamed milk 


Your favorite drinks 丨 Favorite 


W\\tY\ you start a stto^A 

second 把七 Wrty 
•is s*tadkcd or\ b>Y 七 ^ 

-pivst The -f ivsi adtivrty is〆 七 
des-tv-oyed- Instead, "its paused 
七⑶ scoffed, as *rt loses 
-fodus dr>d s*fcops visible *to 
usev. 



Cursors don’t automatically keep track of whether the underlying data in the 
database has changed. If the underlying data changes after the cursor’s been 
created, the cursor doesn’t get updated. It still contains the original records, 
and none of the changes. 


|-f you ufda*tc 七 k da*ta 
•m “e daiabasr. 


id 


2 


3 


NAME 


‘Latte’ 


'Cappuccino 


‘Filter’ 


id 


2 


3 


DESCRIPTION 


'Espresso and steamed milk' 


'Espresso, hot milk and 


NAME 


‘Latte’ 


‘Cappuccino’ 


'Filter 5 


IMAGE RESOURCE ID 


54543543 


654554455 


DESCRIPTION 


'Espresso and steamed milk' 

'Espresso, hot milk and 
steamed-milk foam" 

'Our best drip coffee" 


FAVORITE 


0 


IMAGE RESOURCE ID 


54543543 


654334453 


443S4S34 


… 七 he du\rso\r wok / 七 
it i-p the du\rso\r ； s 

alveady bcch dveated. 


0 


0 



FAVORITE 


0 


So how do we get around this? 
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Change the cursor with changeCursorO 


The solution is to change the underlying cursor used by the favorites list 
view to a new version when the user returns to TopLevelActivity. 
If we do this in the activity’s on Re start () method, the 
data in the ListView will get refreshed when the user returns to 
TopLevel Activity. Any new favorite drinks the user has chosen 
will be displayed, and any drinks that are no longer flagged as favorites 
will be removed from the list. 


To do this, we can use the Curs or Adapter changeCursor () 
method. The changeCursor () method replaces the cursor 
currently used by a cursor adapter to a new one, and closes the old 


cursor. Here’s what the method looks like: 

public void changeCursor(Cursor newCursor) 


^ TWis is ^ cursor you 
£.IaV"SOV" *to use. 


The changeCursor () method takes one parameter, the new cursor. 
Here’s an example of the code in action: 


// Create the new cursor 

StarbuzzDatabaseHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 

Cursor cursor = db•query( n DRINK n , 

new String [ ] { n —id n , n NAME n }, d new du\rso\r m exactly 

"favorite = i n , 七 k way you did bc-(*ov*c- 

null, null, null, null); 


//Get the CursorAdapter used by the ListView 

ListView listFavorites = (ListView)findViewByld(R•id•list_favorites); 
CursorAdapter adapter = 


You yt LisWiev/s 

(Curs or Adapter) listFavorites . getAdapter () ; adapter ush, tW; 

ytAdaftcv-O 


// Change the cursor used by the CursorAdapter to the new one we just created 

adapter. changeCursor (cursor) ; ^ Ihc duvsov- used by "the duv-sov adaplcv "to Ihc 


We’ll show you the revised code for TopLevelActivity.java on the next few 
pages. 
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The revised TopLevelActivity .java code 

Here’s the full Top Lev elActivity.jam code (our changes are in bold): 


V 

v/ 


DrinkActivity 

DrinkCategoryActivity 

Favorites 


package com.hfad.starbuzz; 


□ 


Starbuzz 


public class TopLevelActivity extends Activity { 
QOverride 

protected void onCreate(Bundle savedlnstanceState) 


L n 

app/sre/main 

■lb 

java 


com.hfad.starbuzz 

o 

TopLevel 

//Close the cursor and database in the onDestroy () method Activity.java 

@Override 


These rwcihods hav/e〆 七 


public void onDestroy(){ 

參 • • 

} TW»s yts tailed y/V.c user rcWns -to TofLwlMw’ 七 /. 

public void onRestart() { 
super.onRestart(); 
try{ 

StarbuzzDatabaseHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper(this); 
db = starbuzzDatabaseHelper.getReadableDatabase(); 

Cursor newCursor = db. query ("DRINK" , ^^ V® u d duvsov* exactly 

new String [ ] { ’ ▼ 一 id n , "NAME" } , way you did bc-Pov-c. 

"FAVORITE = l n , 

null, null, null, null); 

ListView listFavorites = (ListView)findViewByld(R.id.list 一 favorites); 
CursorAdapter adapter = (CursorAdapter) listFavorites.getAdapter(); 

6iti list views adapter. 


"the £.u\rsov- used 
by ihe du\rso\r adapiev- 
"to -the r>cw ov\t- 


adapter.changeCursor(newCursor); 
favoritesCursor = newCursor; 
catch(SQLiteException e) { 

Toast toast = Toast.makeText(this, "Database unavailable", Toast.LENGTH SHORT); 


toast.show(); 




pis P lay a message a problem ^ database. 


That’s all the code we need for our top-level activity. Let’s take it 
for a spin and see how it works. 
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Test drive the app 


This time when we flag a drink as being a favorite, it appears in 
TopLevelActivity. When we click on the drink, the app shows 
us the details of that drink. 


cursors and asynctasks 




Drinks 


Your favorite drinks: 

The -favovi-tcs LisWicy/ 
stav*U 


_atte 

Espresso and steamed milk 
Favorite 


0\ 

Wt iidk -the 

■to say -tha-t Latte is a 

-Pavov-iic d\r*mk. 


mcofftt 


Drinks 


Food 


Stores 


Vour favorite drinks: 


Latte 


16:27 


Laiie apfeavs m 七 he 
L'is*t\/'ic>M >wc badk 

bo "fofLcvclA^t' v, *ty* 


Latte 

Espresso and steamed milk 
j Favorite 


iVhch v/c dlidk ov\ Laiic 
•m 七 he TopLcvdA^iiviiy, 

D\rihkA^iiviiy is displayed 
showing details o( ihai 
dhrmk. 



o 


o 


ti 0^# 



Ive been thinking... Using 
databases in my app clearly has 
a lot of advantages, but doesn’t 
opening and reading from the 
database slow the app down? 


Databases are powerful，but they can be slow. 

That means that even though our app works, we need to keep 
an eye on performance... 
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meanwhile … 


databases can make your app go m sloooo - moooo 

Think about what your app has to do when it opens a database. It first 
needs to go searching through the flash to find the database file. If the 
database file isn’t there, it needs to go create a blank database. Then 
it needs to run all of the SQL commands to create tables inside the 
database and any initial data it needs. Finally, it needs to fire off some 
queries to get the data out of there. 

That takes time. For a tiny database like the one used in the Starbuzz 
app, it’s not a lot of time. But as a database gets bigger and bigger, that 
time will increase and increase. Before you know it, your app will lose 
its mojo and will be slower than YouTube on Thanksgiving. 

There’s not a lot you can do about the speed of creating and reading 
from a database, but there is a lot you can do to prevent it slowing up 
your interface. 


Life is better when threads work together 


The big problem with accessing a slow database is that can make your 
app feel unresponsive. To understand why, you need to think about 
how threads work in Android. Since Lollipop, there are three kinds of 
threads you need to think about: 


o 

o 


The main event thread 

This is the real workhorse in Android. It listens for intents, it receives touch messages from 
the screen, and it calls all of the methods inside your activities. 

The render thread 

You don’t normally interact with this thread, but it reads a list of requests for screen 
updates and then calls the low-level graphics hardware to repaint the screen and make 
your app look pretty. 



All of the other thread that you create 


If you’re not careful, your app will do almost all of its work on the 
main event thread. Why? Because it’s the main event thread that runs 
your event methods. If you just drop your database code into the 
onCreate () method (as we did in the Starbuzz app) then the main 
event thread will be busy talking to the database, instead of rushing off 
to look for any events from the screen or other apps. If your database 
code takes a long time, users will feel like they’re being ignored. 

So the trick is to move your database code off the main event 
thread and run it in a custom thread in the background. 
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Cf c ^rpen your pencil 


We’re going to run the DrinkActivity database code in a 
background thread, but before we rush off and start hacking 
code, let’s take a moment to think about what we need to do. 

The code that we have at the moment does three different things. 
Which thread do you think each block of code should run on? 
Choose the type of thread you think each should run on. 


© Set up the interface. 



super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity—drink); 

int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 


Main event thread 

A background thread 

Talk to the database. 



. Choose v/hethev- you 七 iVmk 
《 eadii blodk of dodc should 
be V*uir> ori *tV>C mdm CWvt 


ihvead ov a badkyouy>d 
thvead- 


SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this); 
SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 

Cursor cursor = db.query ("Drink ",... 


Main event thread 

A background thread 




O Update the views with the database data. 


name.setText (...); 
description.setText (...); 
photo.setlmageResource(...); 


Main event thread 

A background thread 
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sharpen solution 


O^terpen your pencil 


We’re going to run the DrinkActivity database code in a 
background thread, but before we rush off and start hacking 
code, let’s take a moment to think about what we need to do. 

The code that we have at the moment does three different things. 
Which thread do you think each block of code should run on? 
Choose the type of thread you think each should run on. 


O Set up the interface. 


super.onCreate(savedlnstanceState); 


setContentView(R.layout.activity—drink); 

int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 


Main event thread 

A background thread 




1/Vc always dvca*tc usev 

oy\ 你 am *tiiv*cad. 


o Talk to the database. 


SQLiteOpenHelper starbuzzDatabaseHelper = new StarbuzzDatabaseHelper (this); 


SQLiteDatabase db = starbuzzDatabaseHelper.getReadableDatabase(); 


Cursor cursor = db.query ("Drink ",... 


Main event thread 

A background thread 





iVe to \ruh 七 he database 

匕 ode m ihc ba^kgv-ou^d because 
•rt’s slow. 


❹ Update the views with the database data. 


name.setText (...); 
description.setText (...); 
photo.setlmageResource(...); 


1/Ve must bo r\AY\ iKc todt bo update i\\t views oy> 
七 Ke ma'm *tWad, oi\\trW\st >wc 3iy\ 


Main event thread 

A background thread 
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What code goes on which thread? 

When you use databases in your app, it’s a good idea to run database 
code in a background thread, and update views with the database 
data in the main event thread. We’re going to work through the 
onFavoritesClicked () method in the DrinkActivity code so 
that you can see how to approach this sort of problem. 

Here’s the code for the method (we’ve split it into sections, which we’ll 
describe below): 

/ /Update the database when the checkbox is clicked 
public void onFavoriteClicked(View view){ 



int drinkNo = (Integer)getlntent().getExtras()•get(EXTRA 一 DRINKNO); 
CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 
ContentValues drinkValues = new ContentValues(); 
drinkValues .put (▼▼ FAVORITE n , favorite. isChecked()); 



SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper(DrinkActivity.this); 

try { 

SQLiteDatabase db = starbuzzDatabaseHelper.getWritableDatabase(); 
db.update("DRINK", drinkValues, 

'▼ 一 id = ?'▼, new String[] {Integer. toString (drinkNo) }); 

db.close (); 

} catch(SQLiteException e) { 



Toast toast = Toast.makeText(this, "Database unavailable", Toast.LENGTH—SHORT); 
toast.show(); 


o 

o 

o 


Code that needs to be run before the database code 

The first few lines of code gets the value of the favorite checkbox, and puts it in the 
drinkValues ContentValues object. This code must be run before the database code. 

Database code that needs to be run on a background thread 

This updates the DRINK table. 

Code that needs to be run after the database code 

If the database is unavailable, we want to display a message to the user. This must run 
on the main event thread. 


We’re going to implement the code using an AsyncTask. So what’s 
that, anyway? 
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AsyncTask 


AsywcTask performs asynchronous tasks 

The AsyncTask class lets you perform operations in the 
background. When they’ve finished running, it then allows you to 
update views in the main event thread. If the task is repetitive, you 
can even use it to publish the progress of the task while it’s running. 

You create an AsyncTask by extending the AsyncTask class, 
and implementing its doInBackground () method. The 
code in this method runs in a background thread, so it’s the 
perfect place for you to put database code. The AsyncTask 
class also has an onPreExecute () method that runs before 
doInBackground ( ) ， and an onPostExecute ( ) method that 
runs afterward. There’s an onProgressUpdate ( ) method if 
you need to publish task progress. 

Here’s what it looks like: 

private class MyAsyncTask extends AsyncTask<Params, 

protected void onPreExecute() { 

//Code to run before executing the task 

} 

protected Result doInBackground(Params... params) { 

//Code that you want to run in a background thread 

} 

protected void onProgressUpdate(Progress... values) { 

//Code that you want to run to publish the progress of your task 

} 

protected void onPostExecute(Result result) { 

//Code that you want to run when the task is complete 


android.os.AsyncTask 
<Params, Progress, Result> 

void onPreExecute () 

Result doInBackground (Params... params) 

void onProgressUpdate (Progress... values) 

void onPostExecute (Result result) 

AsyncTask<Params, Progress, Result 〉 
execute (Params... params) 


Progress, Result> 


java.Iang.Object 

7 \ 


AsyncTask is defined by three generic parameters: Params, 
Progress, and Results. Params is the type of object used to pass 
any task parameters to the doInBackground () method, Progress is 
the type of object used to indicate task progress, and Result is the type 
of the task result. You can set any of these to Void if you’re not going to 
use them. 

We’ll go through this over the next few pages by creating a new 
AsyncTask called UpdateDrinkTask we can use to update drinks in 
the background. Later on, we’ll add this to our DrinkActivity code. 
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The owPrcExGcuteO method 


We’ll start with the onPreExecute () method. This gets called 
before the background task begins, and it’s used to set up the 



task. It’s called on the main event thread, so it has access to views 

in the user interface. The onPreExecute () method takes no - 

parameters, and has a void return type. 

We’re going to use the onPreExecute () method to get the 
value of the favorite checkbox, and put it in the dr in kVa lues 
ContentValues object. This is because we need access to the 
checkbox in order to do this, and it must be done before any of our 
database code can be run. We’re using a separate attribute outside 
the method for the drinkValues ContentValues object so 
that other methods in the class can access it. 

Here’s the code: 

private class UpdateDrinkTask extends AsyncTask<Params, Progress, Result 〉 { 


ContentValues drinkValues; 



wc database Code, wc 


CheckBox favorite = (CheckBox) findViewByld(R. id. favorite); 
drinkValues = new ContentValues(); 

drinkValues .put (，▼ FAVORITE" , favorite. isChecked()); 


Next, we’ll look at the doInBackground () method. 
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doInBackgroundQ 


The dolwPackgrouwdO method 

The doInBackground () method runs in the background 
immediately after onPreExecute () . You define what type of 
parameters the task should receive, and what the return type should 
be. 

We’re going to use the doInBackground () method for our 
database code so that it runs in a background thread. We’ll pass it 
the ID of the drink we need to update, and we’ll use a Boolean 
return value, so we can tell whether the code ran successfully: 



private class UpdateDrinkTask extends AsyncTask<Integer^ 


You *to Ueyv *to 

-the faramc-tcr o( 
dol^Badkyou^dO method. 

This todt r\AY\s m a batk^vouiad *thv-cad- 
protected Boolean doInBackground(Integer... drinks) 



ContentValues drinkValues 


Progress, Boolean 〉 { 

A ： 

>u 七 his ■feo Boolean b> 

maidh 七 he \rciu\r^ -type o( 七 he 
do|hBadkj\rouhdO rwcthod- 


TWis is 扣 a^ay I 士 y", 

bu*t v^’ll just mC-Wdc ov\t 

*tV)C dhrmk IP. 


int drinkNo = drinks[0]; 

SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper(DrinkActivity.this); 

try { 

SQLiteDatabase db = starbuzzDatabaseHelper.getWritableDatabase(); 
db.update("DRINK", drinkValues, 

y '▼ 一 id = ? n , new String[] {Integer. toString (drinkNo) }); 

db. close () ; 

The updaicO me 七 hod uses 七 he 

return true; d,i,k\/alues object ^ Ihe 

} catch (SQLiteException e) { ^cihod 

return false; 


Next, we’ll look at the onProgressUpdate () method. 
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The owProgressUpdateO method 

The onProgressUpdate () method is called on the main event 
thread, so has access to views in the user interface. You can use this 
method to display progress to the user by updating views on the 
screen. You define what type of parameters the method should have. 

The onProgressUpdate () method runs if a call to 
publishProgress () is made by the doInBackground () 
method like this: 

protected Boolean doInBackground ( 工 nteger••• count) { 
for (int i = 0; i < count; i++) { 

publishProgress (i) ; j KlS ta || s o^PvoycssUfda-tcO 

} method, fass'm^ m d value i- 


protected void onProgressUpdate(Integer... progress) { 
setProgress(progress[0]); 




doInBackground 



(^o^rogrcssUpdate 

(^ohPost£xec»te 


We’re not publishing the progress of our task, so we don’t need 
to implement this method. We’ll indicate that we’re not using 
any objects for task progress by changing the signature of 
UpdateDrinkTask: 


WcVc r\o{, us*m^ 

oy>PvoycssUf daicO 

method, so is Void- 


private class UpdateDrinkTask extends AsyncTask<Integer, Void, Boolean 〉 { 


Finally, we’ll look at the onPostExecute () method. 
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onPostExecuteQ 


The owPostExecuteO method 

The onPostExecute () method is called after the 
background task has finished. It’s called on the main event 
thread, so has access to views in the user interface. You can use 
this method to present the results of the task to the user. The 
onPostExecute () method gets passed the results of the 
doInBackground () method, so must take parameters that 
match the doInBackground () return type. 

We’re going to use the onPostExecute () method to check 
whether the database code in the doInBackground () 
method ran successfully. If it didn’t, we’ll display a message 
to the user. We’re doing this in the onPostExecute () 
method as this method can update the user interface; the 
doInBackground () method runs in a background thread, so 
can’t update views. 

Here’s the code: 



OKiPreExecute 




doInBackground 



^ r 


onProgressUpdate 


^ r 



MPostExecut 



private class UpdateDrinkTask extends AsyncTask<Integer, Void, Boolean 〉 

TKis is Boolean, as ouv dokBatk^vo^dO 

\rc*tuv^s a Boolean. 




Pass -the Toas-t "the 


protected void onPostExecute(Boolean success) { 
if (!success) { 

Toast toast = Toast.makeText(DrinkActivity.this, 

"Database unavailable", Toast.LENGTH 一 SHORT); 

toast.show(); 
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The AsywcTask class 

When we first introduced the AsyncTask class, we said it was defined 
by three generic parameters: Params, Progress, and Results. 

You specify what these are by looking at the type of parameters 
used by your doInBackground (), onProgressUpdate (), 
and onPostExecute () methods. Params is the type of the 
doInBackground () parameters, Progress is the type of the 
onProgressUpdate () parameters, and Result is the type of the 
onPostExecute () method: 

private class MyAsyncTask extends AsyncTas k<Params , Progress, Result 〉 

protected void onPreExecute() { 

//Code to run before executing the task 

protected Result doInBackground (Params• params ) { 

//Code that you want to run in a background thread 

protected void onProgressUpdate (Progress... values) { 

//Code that you want to run to publish the progress of your task 

} 

^ 、- 

protected void onPostExecute (Result result) { 

//Code that you wan to run when the task is complete 


In our example, doInBackground () takes Integer parameters, 
and onPostExecute () takes a Boolean parameter. We’re not using 
the onProgressUpdate () method. This means that in our example, 

Params is Integer, Progress is Void and Result is Boolean: 

private class UpdateDrinkTask extends AsyncTask<Integer, Void, Boolean 〉 { 

protected Boolean doInBackground (Integer• drinks) { 


protected void onPostExecute (Boolean... success) { 



You now know everything you need to create a task — let’s see how you run it. 
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Execute the AsywcTask 

You run the task by calling your AsyncTask’s execute () method. If 
your doInBackground () method takes parameters, you add these to the 
execute () method. As an example, we want to pass the drink the user chose 
to the AsyncTask’s doInBackground () method, so we call it using: 

int drinkNo = (工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 

new UpdateDrinkTask().execute(drinkNo); 

The type of parameter you pass with the execute () method must match the 
type of parameter expected by the AsyncTask doInBackground () method. 

Our doInBackground () method takes 工 nteger parameters, so we need to 
pass integers: 

protected Boolean doInBackground (工 nteger••• drinks) { 


We’re going to execute UpdateDrinkTask in DrinkActivity 5 s 
onFavoritesClicked () method. Here’s what the method looks like: 


/ /Update the database when the checkbox is clicked 
public void onFavoriteClicked(View view){ 

int drinkNo = (Integer)getlntent()•getExtras()•get(EXTRA DRINKNO); 



All i\\\s todt is v-cfladcd 
by ouv* /\syv>d"l3sk. 


■^t^bu^DataB^seHelper ^^( 

n^v^S^rb>g7Sla1 pr».i r (i v iT"y . LI 丨 i j ， 


vrih^Tpd>a ns r r^>4wl f T n to S vj^na' 




new 


UpdateDrinkTask () .execute (drinkNo) ; Execute the Asy^Task a^d pass \i the dvmk ID. 


We’ll show you the new DrinkActivity.java code on the next page. 
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The PriwkActivity.java code 

When you create an AsyncTask, you add it as an inner 
class to the activity that needs to use it. We’re going to 
add our UpdateDrinkTask class as an inner class to 
DrinkActivity.java. We’ll execute the task in DrinkActivity’s 
onFavoriteClicked () method so that the task updates the 
database in the background when the user clicks on the favorite 
checkbox. 

Here’s the code: 


package com.hfad.starbuzz; 

import android. os . AsyncTask; Iw'fovt dass. 

public class DrinkActivity extends Activity { 

• • • Wc dor / 七 bo *tKc o^CvcatcO me 七 hod, so vc Id 七 i 七 out. 

/ /Update the database when the checkbox is clicked 
public void onFavoriteClicked(View view){ 



Starbuzz 



app/sre/main 


java 


com. hfad. starbuzz 

LQ 

ID 

DrinkActivity.java 


int drinkNo = ( 工 nteger)getlntent()•getExtras()•get(EXTRA—DRINKNO); 

new UpdateDrinkTask () . execute (drinkNo) ; -task. 


//Inner 

private 


class to update the drink. 
class UpdateDrinkTask extends 


之 d the AsyuTaslc b> the activity as dass. 

AsyncTask<Integer , Void, Boolean 〉 { 


ContentValues drinkValues; 

Bc-Povc -the database to&t 灼 s, fu 七七 he value o( -the 
protected void onPreExecute () { diicdkbo% *m dv*mk\/alucs Cor>*tcir>*t\/al'ACS object 

CheckBox favorite = (CheckBox)findViewByld(R.id.favorite); 

drinkValues = new ContentValues(); 

drinkValues • put (，▼ FAVORITE" , favorite. isChecked()); 


The CoAt 
oy \ ihc 
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The PriwkActivity.java code (continued) 

Ruh the database todt ih a 

protected Boolean doInBackground(Integer. . . drinks) { badk^\rouhd thv-cad. 

int drinkNo = drinks[0]; 

SQLiteOpenHelper starbuzzDatabaseHelper = 

new StarbuzzDatabaseHelper(DrinkActivity.this); 


try { 

SQLiteDatabase db = starbuzzDatabaseHelper.getWritableDatabase(); 
db. update ("DRINK" , drinkValues, 

， ▼ 一 id = ?’▼, new String[] {Integer. toString (drinkNo) }) 

db.close(); 


return true; 
catch(SQLiteException e' 
return false; 




Update *tKc value o( 

•tiic FAVORITE- dolumw 


□ 


Starbuzz 


L Q 

app/sre/main 

-lb 


java 



protected void onPostExecute(Boolean success) { 
if (!success) { 

Toast toast = Toast.makeText(DrinkActivity.this , 

"Database unavailable", Toast.LENGTH SHORT); 


com. hfad. starbuzz 

a 

DrinkActivity.java 


toast, show(); 


r 小 

W the database todt d\d^i v-uh OK 
display a message h> the usev-. 


That’s everything you need in order to create an 
AsyncTask. When the user clicks on the favorite 
checkbox in DrinkActivity, the database gets 
updated in the background. 


In an ideal world, all of your 
database code should run in 
Ae bactgpound. We're not 
going to change our other 
Starfiuzz activities 仂 do 
Ais, but not have a go 
yourself? 
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^ r 



onPostExecute 



I’ve written code before that 
just ran the database code and it was 
fine. Do I really need to run it in the 
background? 

For really small databases, like the 
one in the Starbuzz app, you probably 
won’t notice the time it takes to access 
the database. But that’s just because 
the database is small. If you use a larger 
database, or if you run an app on a slower 
device, the time it takes to access the 
database will be significant. So yes, you 
should always run database code in the 
background. 

Remind me ■ why is it bad to 
update a view from the background 
thread? 



onPreExecute() is used to set up the task. 

It’s called before the background task begins, and runs on the 
main event thread. 



doInBackground() runs in the background thread. 

It runs immediately after onPreExecute () . You can specify 
what type of parameters it has, and what its return type is. 



onProgressUpdate() is used to display progress. 

It runs in the main event thread when the 
doInBackground () method calls publishProgress (). 


onPostExecute() is used to display the task outcome 
to the user when doInBackground has finsihed. 

It runs in the main event thread. It takes the return value of 
doInBackground () as a parameter. 



The short answer is that it will throw 
an exception if you try. The longer answer 
is that multi-threaded user interfaces are 
hugely buggy. Android avoided the problem 
by simply banning them. 

Which part of the database code 
is slowest? Opening the database, or 
reading data from it? 

There’s no general way of knowing. 

If your database has a complex data 
structure, then the first time you open the 
database will take a long time because it 
will need to create all the tables. If you’re 
running a complex query, that might take a 
very long time. In general, play it safe and 
run everything in the background. 


If it take a few seconds to read 
data from the database, what will the 
user see? 

The user will see blank views until 
the database code sets the values. 

Why have you put the database 
code for just one activity in an 
AsyncTask? 

We wanted to show you how to 
use AsyncTasks in one activity as 
an example. In the real world, you should 
do this for the database code in all your 
activities. 
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Your Android Toolbox 


You’ve got Chapter 12 under 
your belt and now you’ve 
added connecting your app to 
SQLite databases to your toolbox. 


You c ^ y \ download 
-full code ^OV 

Wt 切 5:々七叫 价 1.加/ 
HcadP'v-stA^dvoid. 


^BULIET POINTS - 

■ A Cursor lets you read from and 
write to the database. 

■ You create a cursor by calling the 
SQLiteDatabase query () 

method. Behind the scenes, this builds 
a SQL SELECT statement. 

■ The getWritableDatabase() 

method returns a 
SQLiteDat abase object that 
allows you to read from and write to 
the database. 

■ The getReadableDatabase () 
returns a SQLiteDat abase 

object. This gives you read-only 
access to the database. It may also 
allow you to read from and write to the 
database, but this isn’t guaranteed. 

■ Navigate through a cursor using the 

moveTo* () methods. 

■ Get values from a cursor using the 
get* ( ) methods. 


■ Close cursors and database 
connections after you’ve finished with 
them. 

■ A CursorAdapter is an 

adapter that works with cursors. 

Use SimpleCursorAdapter 

to populate a Listview with the 
values returned by a cursor. 

■ Design your app so that you put useful 
content in your top-level activity. 

■ The CursorAdapter 
changeCursor () method 
replaces the cursor currently used by 
a cursor adapter to a new cursor that 
you provide. It then closes the old 
cursor. 

■ Run your database code in 
a background thread using 

AsyncTask. 
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^ At Your Service * 



There are some operations you want to keep on running, 
irrespective of which app has the focus. 

As an example, If you start playing a music file in a music app, you’d probably expect it 
to keep on playing when you switch to another app. In this chapter, you’ll see how to use 
services to deal with situations just like this. Along the way, you’ll see how to use some 
of Android’s built-in services. You’ll see how to to keep your users informed with the 
notification service, and how the location service can tell you where you’re located. 


this is a new chapter 
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Services work behind the scenes 

An Android app is a collection of activities and other 
components. The bulk of your code is there to interact with the 
user, but sometimes you need to do things in the background. 
You might want to download a large file, stream a piece of 
music, or listen for a message from the server. 

These kinds of tasks aren’t what activities are designed to do. In 
simple cases, you can create a thread, but if you’re not careful 
your activity code will start to get complex and unreadable. 

That’s why services were invented. A service is an application 
component like an activity but without a user interface. They 
have a simpler lifecycle than an activity, and they come with a 
bunch of features that make it easy to write code that will run in 
the background while the user is doing something else. 

There are two types of service 

Services come in two different flavors: 


o 

o 


Started services 

A started service can run in the background indefinitely, even when the 
activity that started it is destroyed. If you wanted to download a large 
file from the Internet, you would probably create it as a started service. 
Once the operation is done, the service stops. 

Bound services 

A bound service is bound to another component such as an activity. The 
activity can interact with it, send requests, and get results. A bound 
service runs as long as components are bound to it. When components 
are no longer bound to it, the service is destroyed. If you wanted to 
create an odometer to measure the distance traveled by a vehicle, 
you’d probably use a bound service. This way, any activities bound to 
the service could keep asking the service for updates on the distance 
traveled. 


In this chapter, we’re going to create two services: a started 
service and a bound service. We’ll start with the started service. 
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The started service app 


We’re going to create a new project that contains an 
activity called Main Activity, and a service called 
DelayedMes sage Service. Whenever MainActivity calls 


DelayedMessageService, it will wait for 10 seconds and then 
display a piece of text. 


usc 七 h |S layout 

activity—main.xml 

丁 lie activity will pass 
text -to the sc\rvidc. 





MainActivity.java 


DelayedMessageService.java 


We’re going to do this in three stages: 

Display the message in the log. 

We’ll start by displaying the message in the log so that we can check 
the service works OK. We can look at the log in Android Studio. 

Display the message in a Toast. 

We’ll get the message to appear in a pop-up toast so that you don’t 
have to keep your device connected to Android Studio in order to 
see it working. 

Display the message in a Notification. 

We’ll get DelayedMes sage Service to use Android’s built-in 
notification service to display the message in a notification. This will 
mean that the user will be able to look at the message at a later time. 

Create the project 

We’ll start by creating the project. Create a new Android project for 
an application named “Joke” with a package name of com. hf ad. 
joke. The minimum SDK should be API 16 so that it will work 
with most devices. You’ll need a blank activity called “MainActivity” 
and a layout called “activity—main’’ so that your code matches ours. 


o 

o 

❺ 


The next thing we need to do is create the service. 
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IntentService 


WcYe going to create aw IwtGwtScrvicG 

You create a new service by extending either the Service class or the 
IntentService class. 

The Service class is the base class for creating services. It provides you 
with basic service functionality, and you’ll usually extend this class if you 
want to create a bound service. 

The IntentService class is a subclass of Service that’s designed 
to handle intents. You’ll usually extend this class if you want to create a 
started service. 

As we’re creating a started service, we’re going to add a new intent service 
to the project. To do this, go to File—>New … and select the Service option. 
When prompted, choose the option to create a new IntentService. 
Give the service a name of DelayedMes sage Service, and untick 
the option to include helper start method. This is because we’re going to 
replace the code that Android Studio generates for us. 


You implement an intent service by extending the IntentService 
class and implementing its onHandlelntent () method. This method 
should contain the code you want to run when the service is called: 


package com.hfad.joke; 



T\\\s is dlass 


import android.app.IntentService; 
import android.content.Intent; 

public class DelayedMessageService 


Extend the |htch-tSc\rvidC dUss. 

V 

extends IntentService { 


public DelayedMessageService() { 

super("DelayedMessageService"); 

} p^-t Code you i\\t -to 

@Override 

protected void onHandlelntent(Intent intent) { 
//Code to do something 

} 


We’ll show you an overview of this on the next page. 


□ 

Joke 

1 - [jj 

app/sre/main 



DelayedMessage 

Service.java 
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The IwtGwtScrvicG from 50,000 feet 


We’re using an 工 ntentService to create a started service, so 
lets’s take a look at how they work. 



An activity says what service it needs to call by creating an explicit intent. 

The intent specifies the service it’s intended for. 


o 

MainActivity 


Intent 




To ： DelayedMessageService 
text: 〃 Timing !〃 



The intent is passed to the service. 


o 


Intent 



To ： DelayedMessage 
Service 


MainActivity text: "Timing!” 



Android 


Intent 



To ： DelayedMessage 
Service 
text :〃 Timing!" 


-o 

DelayedMessageService 



The service starts and handles the intent. 

The In tent Service onHandle Intent () method gets called and runs in 
a separate thread. If the service is passed multiple intents, it deals with them in 
sequence, one at a time. Once the service has finished running, it stops. 


o 

DelayedMessageService 



As you can see, a service is started in the same way that you start an 
activity: by creating an intent. The difference is that when you start 
a service, what’s on screen doesn’t change because the service has 
no user interface. 

We want DelayedMessageService to display a message in 
Android’s log. Before we update the service, let’s look at how you log 
messages. 
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Devices : logeat 


Devices 


ADBlogs 


ig level: Verbose t Qr 


app: eom.hfad.joke 


No Connected Devices 


ifSt logcat 

窗 

a 


Nio debuggabfe applications 


» 


This is 七 he loyai avea- 
A^y messages you lo^ 
will appear heve- 


TODO 6 : Android 固 Terminal 


Event Log [=J Cradle Console 


Memory Monitor 



Sclcd*t oP*tioy>. 


welcome to fiskidagurmn 


How to log messages 

Adding messages to a log can be a useful way of checking your code 
is working the way you want. You tell Android what to log in your 
Java code, and when the app’s running, you check the output in 
Android’s log, or logcat. 

You log messages using one of the following methods in the 
Android. util. Log class: 

Log.v(String tag, String message) Logs a verbose message. 
Log.d(String tag, String message) Logs a debug message. 
Log.i(String tag, String message) Logs an information message. 
Log.w(String tag, String message) Logs a warning message. 
Log.e(String tag, String message) Logs an error message. 

Each message is composed of a String tag you use to identify the 
source of the message, and the message itself. As an example, to log 
a verbose message that’s come from DelayedMes sage Service, 
you use the Log. v () method like this: 


Log.v("DelayedMessageService 


This is a message"); 


You can view the logcat in Android Studio, and filter by the 
different types of message. To see the logcat, select the Android 
option at the bottom of your project screen in Android Studio and 
then select the Devices | logcat tab: 

You C^Y\ -fllW OY\ -tilC 

Sclcdi ihc Dcvte|loyai tab. -type message 


Log 

Toast 

Notification 


Thcv-c^s also a Lo^.y/*t-fO 
mcihod you da 灼 use *to v-cfo\rt 
C%dCf*t'ioy>s should WV 

b> 七 he 

dotumCJr>*ta*t'ior>, W lVKa*t 

a Tcvv-iblc Fa*iluvc w . Wc kr>o>w \i 
meav>s 'Wcldomc Piskida^rnrm' 

y/h*itV> vc-fcvs *to -the ^v-ca*t 

pish Pay -festival held a^ually 
•m Palvik, |delair>d- /Wvoid 
Pcvclofcvs da 朽 o-f*tcir> be V>cav-d 
•fco say hW jusi -took ^ 
m*mu*tcs *fco boo*t uf • lVTF?? W 3 s 
a *tv*ibu*tc *to 七 he small *tovm 
^3vc i*ts *to 七 he st 扣 
A^dv-o'id c%cdu*tablc byiedode 
-fovma-t. 



Jnl kJ n b s :z-:a und!Jrt > p — nm 


Maven pro」cict& Cradle 
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The full PelayedMessageService code 

We want our service to get a piece of text from an intent, wait for 10 
seconds, then display the piece of text in the log. To do this, we’ll 
create a showText () method to log the text, and then call it from the 
onHandlelntent () method after a delay. 

Here’s the full code for DelayedMessageService.java (replace the code 
Android Studio has created for you with this code): 

package com.hfad.joke; 


import android.app.IntentService; 
import android.content.Intent; 

import android.util.Log; c / ,.. , 

tk IhtchtScv-vuic dass. 

public class DelayedMessageService extends IntentService { 

Use a b> pass 

public static final String EXTRA 一 MESS AGE = "message" ; ^-3 message -Pv*om 

bo *tV>c scwidc- 

public DelayedMessageService() { 

super ("DelayedMessageService") ; Cd\\ *b^C sufev- dcms*bru 乙 

} 丁 his doh-bihs -the dodc you -to 

the semvide v-cdcivcs ah ih-tcht. 

@Override ^ 

protected void onHandlelntent(Intent intent) { 
synchronized (this) { 
try { 

wait(10000); 

} catch (InterruptedException e) { 
e.printstackTrace(); 

} 


m 


Joke 


^\{, 10 sctor\ds. 


H3 

app/sre/main 


java 



com. hfad .joke 

lcUu F*«ll 


今 e 七七 he 七 wt -P\rom 七 he 

} V 

String text = intent.getStringExtra(EXTRA_MESSAGE); 
showText(text); 

} Call the sKoy/Tex.'tO me-tKod- 

private void showText(final String text) { 


□ 

DelayedMessage 

Service.java 


Log.v("DelayedMessageService", "The message is: 

This logs a piede o ( 七 wt so we see i 七 ii 
"the "thvou^h A^dv-oid S-tudio. 


+ text); 


m 
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declare service 

You declare services m AndroidManifest.xml 

Just like activities, services need to be declared in 
AndroidManifest.xml using the 〈 service 〉 element. This 
is so that Android can call the service; if a service isn’t 
declared in AndroidManifest.xml^ Android can’t call it. 

Android Studio declares the service in AndroidManifest.xml 
for you automatically when you create a new service. Here’s 
what the code looks like: 



Log 

Toast 

Notification 


<?xml version="1.0" encoding= M utf-8"?> 

〈manifest xmlns : android="http :// schemas.android.com/apk/res/android' 
package= M com.hfad.joke" > 


〈application 

… > 

〈activity 

</activity> 


You dctlav-c a 

^dro\d Studio should do tWis 
-Pov* you dvi'towxa'titally. 


□ 

Joke 

413 

app/sre/main 

I 

</ 

AndroidManifest.xml 


〈service 

android : name= M .DelayedMessageService" 
android:exported: n false” > 

〈 /service 〉 sevvide has d . -Pv-ohi o-p 

</application> ^ ^ 卜一 士 

二办七 he package h> dev-ive the 

〈 /manifest 〉 +ully dass 


The 〈 service〉element contains two attributes. 

The android : name attribute tells Android 
what the name of the service is — in our case, 
DelayedMessageService. 

The android : exported attribute tells Android whether 
the service can be used by other apps. Setting it to false 
means that the service will only be used within the current 
app. 

Now that we have a service, we need to run it by getting an 
activity to call it. 
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Add a buttow to activityjwaiw.xml 

We’re going to get Main Activity to start 
DelayedMes sage Service whenever a button is clicked. 

We’ll start by adding the button to MainActivity’s layout. 

First, add the following values to strings.xml (we’ll use them in 
our activity and layout code): 

<string name= n button—response n >Timing!</string 〉 

<string name="button text n >What is the secret of comedy?</string> 



WcVc us'm^ sbr\^s m aff- 


Next, update activity—main.xml so that MainActivity 
displays a button: 


<RelativeLayout xmlns : android:’▼ http://schemas.android.com/apk/res/android 
xmlns : tools= n http://schemas.android.com/tools" 
android : layout_width= n match_parent M 
android : layout_height= M match_parent" 
tools : context:”.MainActivity"> 


Joke 


<Button 

android : layout—width= n wrap—content 
android : layout—height= n wrap—content ▼， 
android : text= "@string/button 一 text，▼ 
android : id= n @+id/button n 
android:onClick= M onClick n 
android : layout_alignParentTop= n true M 
android : layout_centerHorizontal= n true" /> 
</RelativeLayout> 


On the next page, we’ll update the code for MainActivity.java 
so that it starts the service. 


L Q 

app/src/main 



res 


This a buttoh. it s 

t\\ckcd f the ohCkkO method ih 

the activity will get ddlled. 



layout 


</ 


activity— 

main.xml 


WHAT IS THE SECRET OF COMEDY? 
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start service 

You start a service using startServiceO 

You start a service from an activity in a similar way to how 
you start another activity. You create an explicit intent that’s 
directed at the service you want to start. You then start the 
service using the startService () method: 



Log 

Toast 

Notification 


Intent intent = new Intent(this, DelayedMessageService.class); 

startService (intent) ; ^ - - - 、 Stavimj a sev-vide is lust like stavtmj sdiviiy, 

you use s-ta\rtSc\rvidc(; ms-tcad o( star 七 Mtivi 七 yO. 

We’ll use this in MainActivity 5 s onClick () method so 
that the service gets started whenever its button gets clicked. 

Here’s the code: 


package com.hfad.joke; 

import android.app.Activity; 
import android.content.Intent; 

import android.os.Bundle; ^ ^ 忪 se d | asscs . 

import android. view. View; 

public class MainActivity extends Activity { 


□ 

Joke 



app/sre/main 


java 


□ 


com. hfad .joke 

F»T{| 

Q 

DelayedMessage 

Service.java 


@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity 一 main); 

} This will \run y/hch 七 he 

jets disked. Cvca-tc m 七 ⑼ t 

public void onClick(View view) { ^ 

Intent intent = new Intent(this, DelayedMessageService.class); 
intent.putExtra(DelayedMessageService.EXTRA 一 MESSAGE, 

getResources().getstring(R.string.button response)); 




startService(intent); 

S*tav 七 scwidc. 


弋 


Add text "to the ih-tcht 


That’s all the code we need to get our activity to start the 
service. Let’s see what happens when we run the app. 
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H LCE Nexus 4 Android 5.0.1 (API 21) 


El 

B 

m 


Devices I logcat ADB logs 
•ff' Devices 


Log level: Verbose 


app: com.hfad.joke 




愈 


: a logcat 

03-20 15:16:04.228 
03-20 15:16:04.521 
03-20 15:16:04.544 
03-20 15:16:05.144 
03-20 15:16:05.148 


27557-27557/com.hfad.joke I/art : Late-enabling -Xcheck:jni 

27557-27586/com.hfad.joke D/OpenGLRenderer : Render dirty regions requested: true 
27557-27557/com.hfad.joke D/Atlas : Validating map... 

27557-27586/com.hfad.joke I/Adreno-EGL : <qeglDrvAPI_eglInitialize:410>: QUALCOMM Buil 
27557-27586/com.hfad.joke I/OpenGLRenderer : Initialized EGL, version 1.4 


83-20 15:18:16.948 27557-28121/com.hfad.j oke V/DelayedMessageService : The message is: Timing! 


ci 


Project 


O + I 睾 ， r 


ding usage statistics to Google 
make Android Studio better or I don't 




Joke (~/And roidStud ioProjects/Joke) 

► Q .idea 
▼ CSapp 
► D build 
Dlibs 
▼ Dsrc 

► DandroidTest 
▼ C] main 

▼ CHjava 

▼ £] com.hfad.joke 

c h DelayedMessageServii 
c MainAaivity 

▼ Cires 

Itldrawable 

▼ B layout 

«* aaivity_main.xml 

► E] menu 

► £] mipmap-hdpi 

► E] mipmap-mdpi 

► E] mipmap-xhdpi 

► E] mipmap-xxhdpi 

▼ (lvalues 

o dimens.xml 
o strings.xml 
<> styles.xml 

► £] values-w820dp 
<> AndroidManifestxml 

B .gitignore 
all app.iml 

Android DDMS 


c Ma'nActivity.java x <> activity_mainj<ml x c Delayed 
! lockage com.hfad.joke; 

import android.app.Activity; 
import and roid.content.Intent; 
import and roid.os.Bundle; 

令 import android.view.View; 

:> public class MainActivity extends Activity { 

^Override 

*T 0 protected void onCreate(Bundle savedlnstanceState) { 
super. onCreate(savedlnstanceState); 
setContentView(R.layout. activity_main ) ; 


public void onClick(View view) { 

Intent intent = new Intent(this, DelayedMessageService. class) ; 

intent.putExtra( "text", getResources().getString(R.string. button_response) ); 

sta rtService(intent); 


睾， 




Log 

Toast 

Notification 



This is the 
1 。 3 乙 at v/ihdov/. 



Test drive the app 


When you run the app, MainActivity is displayed. It contains a 
single button: 



Press the button, switch back to Android Studio, and watch the 
logcat output in the lower-right corner of the IDE. After 10 
seconds, the word “Timing!” appears in the logcat. 


e o o 


(jj MainActivity.java - [app] - Joke - 卜 /AndroidStudioProjects/Joke] 


D t X 

Joke C app C] sre 


^ *r app - ►你 茗 ILSw 

java com hfad joke c MainActivity 


Help improve Android Studio by seni 
Please click I agree if you want to help 










03-20 15:18:16.948 27557-28121/com.hfad.joke V/DelayedMessageService : The message is: Timing! 


Now that we know the service works, let’s make it display a 
message on the screen so you don’t have to keep your device 
plugged into your computer to see it running. 


a 10-scdov\d delay ； *tV^c 

message is displayed m I03. 


hfad .joke (27557) 


B 


o _: »•© 豳 



l/la.t- J o> rd u.«NI -lc «/llc.2 J fd> pl-5g ir 


J uarojd T *p al JnJ u nJJS :Z 
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display toast 


Wc wawt to send a message to the screen 



Log 

Toast 

Notification 


Services don’t have user interfaces like activities do, but that 
doesn’t mean that they don’t need to keep the user informed 
about stuff that’s happening. The user might need to know 
when a file has been downloaded, for instance. 

In our case, it would be a lot neater if we could display a 
message in a toast on the screen instead of in the log. There’s 
just one thing — any code that updates the user interface needs 
to run in the main thread 


Screen updates require the main thread 

As you’ve seen, when you use an intent service, you put the code 
you want to run in the onHandleIntent () method. This 
code then runs in the background in a separate thread. This is 
great for code that you want to run in the background, but not 
so great if you want to update the user interface. This is because 
you can only update the user interface in the main thread. 



lA/cll jet stW\U *to display 
a messay … a 


To get around this, we’ll use a handler. As we said back in 
Chapter 4, a handler lets you post code that needs to be run to 
a separate thread. We can use the handler post () method to 
post the code to create a toast to the main thread. The code will 
then run on the main thread and the toast will get displayed 
correctly. 


To get the code working, we need to do the following: 


o 

o 


Create a handler in the main thread. 

Use the Handler post () method in the service 
onHandle Intent () method to display a toast. 


The first thing we need to look at is how to create a handler in 
the main thread. 
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OHStartCommandt) runs oh the mam thread 

To create a handler on the main thread, we need to create a 
Handler object in a method that runs on the main thread. We 
can’t use the onHandleIntent () method, as this runs in a 
background thread. Instead, we’ll use the onS tart Command () 
method. 

The onS tart Command () method gets called every time the 
intent service is started. The onS tart Command () method runs 
on the main thread, and runs before the onHandlelntent () 
method. If we create a handler in the onStartCommand () 
method, we’ll be able to use it to post code to the main thread in 
the onHandlelntent () method: 


public class DelayedMessageService extends 工 ntentService { 

private Handler handler; Add ha.dle, as a —A viable so 

w'CxKods BCttSS 1*0- 


@Override 


This method \ruhs ov\ the maih thread, so it 

a hew hahdlcv oh -the maih thv-cad. 


public int onStartCommand(Intent intent, int flags, int startld) { 
handler = new Handler(); 

return super.onStartCommand(intent, flags, startld); 


Call |r>*tcy>*tScv-v"idC oy>S*tav-*tCommair>d() method. 


QOverride 

protected void onHandlelntent ( 工 ntent intent) { 

/ /Use the handler to post code to the main thread 


□ 

Joke 

L C3 

app/sre/main 


When you use the onStartCommand (), you must call its super 
implementation using: 



com. 


DelayedMessage 

Service.java 


hfad.joke 

a 


super•onStartCommand(intent, flags, startld) 


This is so that the intent service can properly handle the life of its 
background thread. 

On the next page, we’ll show you the full code for 
DelayedMessageService.java and then look at it running. 
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DelayedMessageService code 


The full <?elayedMessageService.java code 

package com.hfad.joke; 


Q 


Log 

Toast 

Notification 


import android.app. 工 ntentService; 
import android•content•Intent; 

import android.os.Handler; 
import android.widget.Toast 



WcVc us'm^ *tV^csc dUsscs. 


public class DelayedMessageService extends IntentService { 

public static final String EXTRA—MESSAGE = "message"; 

private Handler handler; <- Add the ha^dlcv- as a hew vaHablc. 

public DelayedMessageService () { 

super("DelayedMessageService"); 

Cv*ca*tc V>ar>dlcv* oy \ mam 七 hvead. 

@Override 士 

public int onStartCommand(Intent intent, int flags, int startld) 
handler = new Handler(); 

return super.onStartCommand(intent , flags, startld); 

} 》 

l/Vc \rc hot this method. 

@Override ^ 

protected void onHandlelntent(Intent intent) { 

synchronized (this) { 


□ 


Joke 


try 


wait (10000); 

catch (InterruptedException e) 
e.printStackTrace(); 


L Q 

app/sre/main 

■]_1 


String text = intent.getStringExtra(EXTRA_MESSAGE); 
showText(text); 


java 

jl 

com.hfad .joke 

Q 

DelayedMessage 

Service.java 


private void showText(final String text) { 

handier • post (new Runnable (> d PosUhe Toast todt bo Ihe r ， ai, 

"thv-cad us*mj -the hdruilev. 


@Override 


public void run() { 

Toast.makeText(getApplicationContext(), text. Toast.LENGTH— LONG).show() 


})； 


This is i\)t you bo display 七 he *toas 七 m. 

TV>cv-c s move aboui *th*is oy \ *thc fay 
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The application context 

Let’s take a closer look at the line of code that displays the toast: 

Toast.makeText(getApplicationContext (), text. Toast•LENGTH—LONG).show(); 


Q 


Log 

Toast 

Notification 


The first parameter of the Toast. makeText () method is the 
context in which you want the toast to appear. When you create 
a toast in an activity, you use this to pass it the instance of the 
current activity. 

This doesn’t work in a service, because the service context doesn’t 
have access to the screen. Whenever you need a context in a service 
in situations like this, you must use getApplicationContext () 
instead. This gives us the context for whatever app happens to be in 
the foreground when the code is run. It means that the service will 
be able to make a toast appear, even if we’ve switched to a different 
app. 


Test drive the app - 

Let’s try running our app again. 

When you click on the button in MainActivity, 
a toast appears after 10 seconds. The toast appears 
irrespective of which app has the focus. 

If you click on the button multiple times in quick 
succession, multiple toasts appear about 10 seconds 
apart. The service deals with each intent it receives, 
one at a time. 
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Can we improve ow using Toasts? 

We now know how to send a piece of text to the screen using 
a toast. That’s useful if we want to tell the user that, say, the 
very long download of a file has completed. But the truth 
is toasts don’t really stand out that much, and if you’re not 
looking at the screen at exactly the right moment, you don’t 
even see them. If we really want to keep the user informed 
about important stuff, we need to replace our toast with a 
notification. 

Notifications are messages that appear in a list at the top of 
the screen. If the user doesn’t happen to see the notification 
at the time it was created, it doesn’t matter. She can still see 
them by dragging her finger down from the top of the screen 
to open the navigation drawer. 



Log 

Toast 

Notification 


TV^'»s is a 

I Timing! 


These a\re hoti-fidatioh idohS. 


TWis is drawer. 



To send the notification, we’re going to use one of Android’s 
built-in services, the notification service. 

Android comes with a number of built-in services that you 
can use in your app. These include the alarm service (used 
for controlling alarms), the download service (used for 
requesting HTTP downloads), and the location service (used 
for controlling location updates). 


You use the notification service to manage notifications. We’ll 
give you an overview of how it will fit in with the app on the 
next page. 
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How you use the wotificatiow service 

Here’s an overview of how our app will work with the Android 
notification service: 


o MainActivity starts DelayedMessageService by passing it an intent 



Intent 


"Timing ! 1 

MainActivity DelayedMessageService 




DelayedMessageService creates a new Notification object. 

The Notification object contains details of how the notification should be 
configured, such as its text, title, and icon. 



o text="Timing!" 


DelayedMessageService 


Notification 



DelayedMessageService creates a NotificationManager object to 
access Android's notification service. 

DelayedMessageService passes the Notification object to the 
NotificationManager, and the notification gets displayed. 



We’ll start by creating the notification. 
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build a notification 


You create wotificatiows using a 
notification builder 



Log 

Toast 

Notification 


You create a notification using a notification builder to create a 
new Notification object. The notification builder allows 
you to create a notification with a specific set of features, without 
writing too much code. Each notification must include a small 
icon, a title, and some text. 

Here’s an example of the code you use to create a notification. 

It displays a high priority notification that vibrates when the 
notification appears and disappears once it’s clicked: 


This displays a 
hotitidatioh. 
ido” 一 ih this CSsc, 
"the nr»ipwr»ap called 


Notification notification 


new Notification.Builder(this) 


..setSmalllcon (R.mipmap. ic—launcher) 

• setContentTitie (getstring (R. string. app_name)) 七 ’ 七 lc and 七 € 乂七 ’ 

• setCon ten tText (text ) 《一 ‘ 一一 一 — 

.setAutoCancel (true) 則 disappeav- when didked. 

• setPriority (Notification. PRIORITY 一 MAX) ^^ ^ a f\r'io\r*i*ty av>d 

.setDefaults (Notification • DEFAULT 一 VIBRATE) 〆 sc*t *i*t *fco v*ibv-a*tc *to 3 


.build (); 


w Kcads v>oti-f *idatioy>. 


These are just some of the properties that you can set. You can 
also set things like visibility to control whether the notification will 
appear on the lock-screen, a number to display a count next to 
the notification in case you want to send many notifications from 
the same app, and a sound to make the notification make a noise. 
You can find out more about these properties here: 

https:/ / developer, android, com/reference/android/app/ 
Notification.Builder.html 

It’s also a good idea to say which activity should be displayed 
when the user clicks on the notification. In our case, for instance, 
we can get Android to display MainActivity when the 
notification is clicked. We’ll show you how to do this on the next 
page. 



Some of 
the 

notification 
properties 
require API 


level 16 or above. 


If you need to support 
older devices, you won’t 
be able to use all of the 
properties. 
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fretting your wotificatiow to start aw activity 


You get a notification to start an activity when it’s clicked using a 
pending intent. A pending intent is an intent an app can pass to 
other applications so that they can submit the intent on your app’s 
behalf at a later time. 


Here are the steps you go through to create the pending intent: 


1. Create aw explicit intent 


First, you create a simple explicit intent directed to the activity you 
want to start when the notification is clicked. In our case, we’ll start 
MainActivity: 


Tins is d 

s*tav"*ts MamA^Wi-ty* 


Intent intent = new Intent(this, MainActivity.class); 



Intent 


^3 


To ： MainActivity 

DelayedMessageService 

Z. Pass the intent to the TaskStackPuilder 

Next, we use a TaskStackBuilder to make sure that the 
back button will play nicely when the activity gets started. The 
TaskStackBuilder allows you to access the history of activities 

used by the back button. We need to get the back stack related to the Cv-ca^tc d TaskS-tadkBuildcv 
activity, and then add the intent we just created to it: ^ 

TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); 
stackBuilder.addParentS tack(MainActivity.class); 

stackBuilder. addNextlntent (intent) ; ^_Tiicsc I'mes make 七 he badk butto 灼 >wovk 

fv-ofcvly 七 he adtivi-ty is s*ta\rtcd- 


Here's an intent for 
MainActivity. Can you 
add it to MainActivitys 
back stack? 


0 



Intent 




To: MainActivity 




DelayedMessageService 


TaskStackBuilder 


The story continues on the next page. 
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$. ^et the pending intent from the TaskStack^uilder 

Next, we get the pending intent from the TaskStackBuilder using 
its getPendinglntent () method. The getPendinglntent () 
method takes two int parameters, a request code that can be used to 
identify the intent, and a flag that specifies the pending intent’s behavior. 

Here are the different flag options: 



Log 

Toast 

Notification 


FLAG_CANCEL_CURRENT If a matching pending intent already exists, cancel it before 

generating a new one. 

FLAG_NO_CREATE If a matching pending intent doesn't already exist, don't 

create one and return null. 


FLAG_ONE_SHOT The pending intent can only be used once. 

FLAG 一 UPDATE 一 CURRENT If a matching pending intent already exists, keep it and 

replace its extra data with the contents of the new intent. 


In our case, we’ll use FLAG_UPDATE_GURRENT to modify any 
existing pending intent. Here’s the code: 

^TWis dv-catcs f ⑼ dm3 \v\icY\i- 

Pendinglntent pendinglntent = 、匕 

stackBuilder.getPendinglntent(0, Pendinglntent.FLAG UPDATE CURRENT) 


Pendinglntent 

E3 - 


l J To: MainActivity 

DelayedMessageService TaskStackBuilder 



4. Add the intent to the notification 

Finally, you add the pending intent to the notification using the 
setContentlntent () method: 

notification.setContentlntent(pendinglntent) 


Pendinglntent 


Add ihc b> ihc 

< - 七 ha 七 starts \i l s dideed. 


so 




To: MainActivity 



DelayedMessageService 


Notification 


Once you’ve given the notification a pending intent telling it which 
activity to start when it’s clicked, all that’s left is to display it. 
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Send the wotificatiow using the 
wotificatiow service 

So far we’ve looked at how to create and configure a notification. 
The next thing is to pass it to the Android notification service so 
that it appears on the device. 

You access Android’s built-in services using the 
getSystemService () method. It takes one argument, the 
name of the service you want to use. 


In our case, we want to use the notification service, so we use 
code like this: 


TWis "is an IP WC II use (or 七 ’ cm. 


public static final int NOTIFICATION—ID = 5453; 

一 This is how you BCCcss Android’s 

r>o-ti-fida-tioh scv-vidc. 

NotificationManager notificationManager = ^ 

(NotificationManager) getSystemService(Context.NOTIFICATION 一 SERVICE); 


notificationManager.notify(NOTIFICATION—ID, 

The NOT IFI CAT I ON 工 D is used to identify the notification. If 
we send another notification with the same ID, it will replace 
the current notification. This is useful if you want to update an 
existing notification with new information. 


notification); 




Use i\\t nation strict *to 

display wc dv-ca*tcd. 


The notification service deals with all of the issues involved in a 
background service sending updates to the screen. This means 
that you no longer need to use a handler in order to update the 
user interface; the notification service handles it for you. 


On the next page, we’ll show you the updated code for 
DelayedMessageService. 


iheveiciVe no ^ 

Dumb Questi9ns 


Why do I need to include an icon in a 
notification? 

The notification system needs an icon to display the 
notification at the very top of the screen. 


Q/ What happens if I don’t set the priority and 
switch vibrate on? 

The notification will still be sent, but it won’t pop up 
on your screen. You’ll still see it listed in the navigation 
drawer. 
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DelayedMessageService code 


The full code for PelayedMessageServicejava 

Here’s the full code for DelayedMessageService.java. It now 
uses a notification instead of a toast to display a message: 



Log 

Toast 

Notification 


package com.hfad.joke; 

import android.app. 工 ntentService; 

import android.app.Notification; 
import android.app.NotificationManager; 
import android.app.Pendinglntent; 
import android.app.TaskstackBuilder; 
import android.content.Context; 
import android.content•Intent; 


□ 


Joke 


app/sre/main 
e 乂七⑸ Classes’ jaya 



^ ho displayihg a Toast, 
so wc dov\-i heed these imports. 



com. hfad .joke 

I 1<Um 

a 

DelayedMessage 

Service.java 


public class DelayedMessageService extends 工 ntentService { 


public static final String EXTRA—MESSAGE = "message"; 


public static final int NOTIFICATION ID = 5453; 


public DelayedMessageService() { 

super("DelayedMessageService"); 


TWis \s used -to \dc^h(y 

|*t dould be 3v\y r\uw\bcv-> 

y/C just decided ov\ 弓 ^ 4 


@Override 



protected void onHandlelntent ( 工 ntent intent) { 


synchronized (this) { 


try { 

wait(10000); 


} catch ( 工 nterruptedException e) { 
e.printStackTrace(); 

} 

} 

String text = intent•getStringExtra(EXTRA—MESSAGE); 
showText(text); 
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The PelayedMessageServicejava code (continued) 





y\o lor\^CV" us'mj 
a tta^dlcv-, so v/c do 灼七 
r\ttA *tV^is method- 


private void showText(final String text) 



ho lohgc^r displayihg the message usmg a Toast 


Ortd^Jt 


- 4 ^ 

Intent intent = new Intent(this, MainActivity.class); 

TaskstackBuilder stackBuilder = TaskStackBuilder.create(this); 

stackBuilder. addParentStack (MainActivity. class) ; Use 9 TaskS-ta^kBuildcv* "to make 

stackBuilder.addNextlntent(intent); 

Pendinglntent pendinglntent = 

stackBuilder.getPendinglntent(0, Pendinglntent.FLAG UPDATE CURRENT 


… ▽ 似 c d (dSK^tatKOuildcv to mak( 

bad bu-t-toh play widely av\d 

乙 … 七 C the pChdihJ ihicht. 


Build h\t ^ot»-f*ida*tio^. 


Notification notification = new Notification.Builder(this) 

.setSmalllcon(R.mipmap.ic—launcher) 

.setContentTitle(getString(R.string.app— name)) 

.setAutoCancel(true) 

.setPriority(Notification.PRIORITY— MAX) 

.setDefaults(Notification.DEFAULT 一 VIBRATE) 

.setContentlntent(pendinglntent) 

.setContentText(text) 

.build (); 

NotificationManager notificationManager = 

(NotificationManager) getSystemService(Context.NOTIFICATION 一 SERVICE) 
notificationManager.notify(NOTIFICATION—ID, notification); 

Display "the us'mj 七 he /Udvoid hoti-Pidatioh sev-vide* 


That’s all the code we need for our started service. Let’s go 
through what happens when the code runs. 
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What happens when you ruw the code 


Before you see the app up and running, let’s go through what 
happens when the code runs: 



Main Activity starts DelayedMessageService by passing it an intent. 

The intent contains the message MainActivity wants 
DelayedMessageService to display. 



Intent 


"Timingr 

MainActivity DelayedMessageService 




DelayedMessageService waits for 10 seconds. 



DelayedMessageService 


❺ DelayedMessageService creates an intent for MainActivity 


Intent 



To ： MainActivity 


DelayedMessageService 


o 


DelayedMessageService creates a TaskStackBuilder and asks it to 
add the intent to Main Activity’s back stack. 


o 

DelayedMessageService 



TaskStackBuilder 
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The story continues 



The TaskStackBuilder use the intent to create a pending intent and 
passes it to DelayedMessageService. 




DelayedMessageService 


TaskStackBuilder 


o 


DelayedMessageService creates a Notification object, sets details 
of how it should be configured, and passes it the pending intent. 



Pendinglntent 



To: MainActivity 



text^’Timing” 


DelayedMessageService 


Notification 


o 


DelayedMessageService creates a NotificationManager object to 
access Androids notification service and passes it the Notification. 

The notification service displays the notification. 


Pendinglntent 






To ： MainActivity 
text="Timing !〃 


DelayedMessageService 


NotificationManager 


Notification 



When the user clicks on the Notification, the Notification uses its 
pending intent to start MainActivity. 



Notification MainActivity 


Let’s take the app for a test drive. 
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Test drive the app 


When you click on the button in MainActivity, a 
notification is displayed after 10 seconds. You’ll receive the 
notification irrespective of which app you’re in. 



Log 

Toast 

Notification 


15:16 


WHAT IS THE SECRET OF COMEDY? 


r 

Clidk oh the but*to» 


a delay, afpea^rs. 

0v\ older devices, you -to o^y\ 

•tV^c dbrawer *to see it. 


" 1 

WEATHER 

HbUIA 

PLAYER 


RunKeeper 

BBC Weather 

/ 

BBC Media.. 

Headspace 

X 

>/ 

% 

B] 

MyFitnessPal 

Any.do 

Keep 

ZazenMedit. 


When you click on the notification, Android returns you to 
MainActivity. 


Clidkihg Oh the hoti-pidatioh stav-ts 

MaihAdivity, just as wc wa 士 d. 



So far you’ve seen how to create a started service that displays 
a notification using the Android notification service. After an 
exercise, we’ll look at how you create a bound service. 
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Service Magnets 


Below you’ll see most of the code needed to create a started service 
called WombleService that plays a .mp3 file in the background, 
and an activity that uses it. See if you can finish off the code. 


^TW»s is scv-vitc. 


public class WombleService extends 


public WombleService() { 

super("WombleService"); 


QOverride 

protected void (Intent intent) { 

MediaPlayer mediaPlayer = 


MediaPlayer.create(getApplicationContext (), R.raw.wombling_song); 


mediaPlayer.start() 


This uses -the A^dvoid MediaPlayer class io flay a ^ile tailed 

叶 1 The -file is lodaicd m ihc ves/rav/ (older. 


TV^is is a£.*tWi*tY* 

public class MainActivity extends Activity { 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 

super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_main); 


public void onClick(View view) { 


Intent intent = new 工 ntent(this. 


(intent); 
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Service Magnets Solution 


Below you’ll see most of the code needed to create a started service 
called WombleService that plays a .mp3 file in the background, 
and an activity that uses it. See if you can finish off the code. 

^TW»s *»s sc\rv*itc. It 

public class WombleService extends i ^l^ss. 



public WombleService() { 

super("WombleService"); 

} 

@Override - - 

protected void (Intent intent) { 

MediaPlayer mediaPlayer = 

MediaPlayer.create(getApplicationContext(), R.raw.wombling_song) 
mediaPlayer.start(); 


丁 k (Lode heeds -to V-Uh ih the 

OhttahdlcIhtch-tO method. 


^TWis is -tV^c adtivity. 

public class MainActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedlnstanceState) 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity main); 




Cvcatc 3 iv\ 

di\rc^icd a-t iVorwblcScv-vidC dlass. 


public void onClick(View view) { 

Intent intent = new 工 ntent(this 


(intent) 




Sta\rt the 


service- 


u did^*t ir>ccd *to 
use -these ma^c*U- 
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Poimd services are more interactive 

As we said earlier, a started service runs in the background indefinitely, 
even when the activity that started it is destroyed. Once the operation 
is done, the service stops itself. 

A bound service is bound to another component such as an activity. 
The activity can interact with it, send requests, and get results. To 
see this in action, we’re going to create a new app that uses a bound 
service that will work like an odometer to track the distance traveled 
by a vehicle. 

How the odometer app will work 

We’re going to create a new project with an activity called 
MainActivity, and a service called Odometer Service. 
MainActivity will use OdometerService to get the distance 
traveled. 



MainActivity binds to OdometerService. 

MainActivity uses the OdometerService getMiles () 
method to ask for the number of miles traveled. 


❺ The OdometerService uses the Android location services to 
keep track of when the device moves. 

It uses these locations to calculate how far the device has traveled. 

❺ The OdometerService returns the distance traveled to 
MainActivity. 

MainActivity displays the distance traveled to the user. 



activity—main.xml 


o getMilesQ 



TVis is 

*to /\\r\dv"Old- OuV" 

>Mlll 

use \i bo l*is*tch -fov- 




Android 

Location 

Service 


MainActivity.java 


OdometerService.java 


The o( miles *tvavclcd- 


We’ll start by creating the service. Let’s see what we need to do. 
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The steps needed to create the OdomctcrScrvicc 

There are a few steps we need to go through in order to 
create the Odometer Service: 



Binder 

Location 

getMilesQ 



Define an Odometer Binder. 

A Binder object allows activities to bind to services. We’ll define a 
subclass of Binder called Odometer Binder that will enable our 
activity to connect to the Odometer Service. 



OdometerBinder 



Create a LocationListener and register it with Androids 
location service. 

This will allow the OdometerService to listen for changes in the 
device location and work out the distance traveled in meters. 




Android 

Location 

Service 



Create a public getMiles() method. 

The activity will be able to use this to get the number of miles traveled. 


getMilesQ 




0.5 



MainActivity 


OdometerService 


We’ll start by creating a new project for our Odometer app. 
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Create a new Odometer project 


Create a new Android project for an application named “Odometer” 
with a package name of com . hf ad. odometer. The minimum 
SDK should be API 16 so that it will work with most devices. You’ll 
need a blank activity called “MainActivity” and a layout called 
“activity_main” so that your code matches ours. 

We’re going to add a new service to the project. This time we’re 
going to use a service that extends the Service class and not the 
Intent Service class. This is because the Intent Service class 
is intended for services that handle intents, as we did in the previous 
example. In this case, we’re going to start the service by binding to it 
so there’s no advantage in using the In tent Service class. 

You add a service that extends the Service class in a similar way 
to how we added a service earlier. Go to File^-New... and select 
the Service option. When prompted, choose the option to create a 
new Service (not an IntentService), and give the service a name of 
“OdometerService”. Untick the “exported” option as this only needs 
to be true if you want services outside this app to access the service. 
Make sure that the “enabled” option is ticked; if it isn’t, the activity 
won’t be able to run the app. 



i\\c ^lass Kicv-av-^y 
-fov" Scv"Vifi.c class. 


Here’s what the code looks like to create a bound service based on 
the Service class: 


package com.hfad.odometer; 



import 

import 

import 


public 


android.app.Service; 


Odometer 

L Q 


android.content.Intent; 
android.os.IBinder; 


The tlass c^i^ds Scrv*»tc dass. 


class OdometerService extends Service { 


app/sre/main 




com.hfad.odometer 


o^Bi^dO method is used -Pov 

@Override bmdmg 匕 orwpo 灼 errts "to "the scv*vidc- 

public IBinder onBind(Intent intent) { 

//Code to bind the service 



Odometer 

Service.java 


The onBind () method is used to bind the service to an activity. 
We’ll look at how binding works on the next page. 
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How binding works 

This is how an activity binds to a bound service: 



Binder 

Location 

getMilesQ 




The activity creates a ServiceConnection object. 

A ServiceConnection is used to form a connection with the service. 

<:> ~ 

MainActivity ServiceConnection 

The activity passes an Intent down the connection to the service. 

The intent contains any additional information the activity needs to pass to the 
service. 


o 



MainActivity 


ServiceConnection 


OdometerService 



The bound service creates a Binder object. 

The Binder contains a reference to the bound service. The service sends the Binder 
back along the connection. 


o 

MainActivity 




When the activity receives the Binder, it takes out the Service 
object and starts to use the service directly. 


o 一 o 

MainActivity OdometerService 


To allow the activity to bind to the service, we need to get 
the service to create the Binder object, and pass it to the 
activity using its onBind () method. 
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Pefiwc the Piwder 


When an activity asks to bind to a service using a service connection, 
the connection calls the onBind () method of the service. The 
onBind () method returns a Binder back to the connection. This 
is then passed back to the activity. 

When you create a bound service, you need to define the Binder 
yourself. We’re going to define a Binder called OdometerBinder 
by declaring it as an inner class like this: 

public class OdometerBinder extends Binder 



you ertait a bo^d service, you 

-to provide a B'mdcv- imflemerrtaticrn. 




We’ll then return an instance of the OdometerBinder in the 
service onBind () method: 


import android.os.Binder; ^ ^ ^csc dlasscs. 

import android.os.IBinder; 


public class OdometerService extends Service { 

private final IBinder binder = new OdometerBinder(); 


□ 


Odometer 


L Q 

app/sre/main 

"III 


java 


□ 


public class OdometerBinder extends Binder 
OdometerService getOdometer() { 


com. hfad. odometer 


return OdometerService.this 


The B'mdcv implementation. £j 


Odometer 

Service.java 


@Override 

public IBinder onBind(Intent intent) { 
return binder; 

} — 卜 dO method \rctu\rhs (Bihdcv-. This 

如 Ihtcvla^c the Bihdcv- dass —U ⑶ Is. 


is 


When the activity binds to the service with a service connection, 
the connection will call the onBind () method, which will 
return the OdometerBinder object. When the activity receives 
the OdometerBinder from the connection, it will use the 
getOdometer () method to get the OdometerService object. 


loy^W see -bWis *m attlOh Y/e 
dvea-tc uses 

SCV"V'ltC. 
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fret the service to do something 

The next thing we need to is get our service to do something. We 
want our service to be able to tell the activity how far the device 
has traveled. There are two things we need to do to enable this: 



Binder 

Location 

getMilesQ 



Set up a listener when the service gets created that 
will listen for changes in the device location. 





OdometerService 


LocationListener 



Return the number of miles traveled to the activity 
whenever the activity asks for it. 



Let’s start by looking at what methods are available in the 
Service class that might be useful to us. 
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The Service class has four key methods 

We’re creating a bound service that extends the Service class. The 
Service class has four key methods that you might want to use: 


Method 


When it’s called 


What you use it for 


onCreateQ 


When the service is first One-time setup procedures, 

created such as instantiation 


onStartCommandO When an activity starts 

the service using the 

startService() 

method 


You don’t need to implement 
this method if your service 
isn’t a started service; it will 
only run if the service is started 
using startService () 


onBindQ 


When an activity wants to 
bind to the service 


You must always implement 
this method by returning an 
工 Binder object; if you don’t 
want activities to bind to the 
service, return null instead 


onDestroy O When the service is no Use this method to clean up 

longer being used and is any resources 

about to be destroyed 


In our case, we want to start getting location updates when the 
service is created. As this is a one-time setup, we’ll do this in the 
onCreate () method: 


@Override 

public void onCreate() 


{ TW»S IS y/V^a-t tVic Scrvidc oXrtaitO method looks l«kc. 


//Code to set up the listener 


On the next page, we’ll look at how we can get location updates. 
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Location, location, location... 

If you want to find out the location of your device, you use the 
Android location service. The location service uses information from 
the GPS system and the names and strengths of nearby WiFi networks 
to find your location on the surface of the Earth. 



Binder 

Location 

getMilesQ 


You start by creating a LocationListener. A location listener is 
used for getting updates on when the device location has changed. 

You create the location listener like this: 

LocationListener listener = new LocationListener() { 


is L-oC.3"bioK\L-is*bc^cv". 


@Override 



public void onLocationChanged(Location location) { 

//Code to keep track of the distance 

} This mc-thod jets called -the LotahoY\L\sicY\^ is -told -the device 

loda-tioh has The Lodatio^ pa\ramcic\r describes 七 he dum 灼七 loda-tio^ 

@Override 

public void onProviderDisabled(String argO) {} 

*to ovcr'idc tV^csc methods *too, 

@Override 

public void onProviderEnabled(String argO) 


@Override 


^ but ^ be Ic-ft emfty. T\\q jet 
{} dallcd i\\t ^PS is enabled ov disabled, 
/ or j i*b s*ta*tus )ias lA/!c dor\*t 

y,ccd -to bo a^y events. 


public void onStatusChanged(String argO, int argl. Bundle bundle) {} 


To keep track of distances in location, you need to override the 
LocationListener onLocationChanged () method. 
This method has one parameter, a Location object that 
represents the device current location. 

You can find the distance in meters between two locations using 
the Location distanceTo () method. As an example, if you 
use a Location object called lastLocation to record the 
device’s last location, you can find the distance in meters between 
the locations using: 


double distanceInMeters = location.distanceTo(lastLocation); 


We’ll show you the full code for the listener on the next page. 
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Add the LocatiowListewcr to the service 

Here’s the revised code for OdometerService.java (the onCreate () 
method includes a location listener that keeps track of the distance the 
device has traveled): 


public class OdometerService extends Service 


nv 



Odometer 


H3 


app/sre/main 

L Q 

java 


com. hfad.odometer 


private static double distancelnMeters; 
private static Location lastLocation = null; 

A 

、 WlcVc -the dista^c traveled metevs av\d 

■the last lodatio^ as pv-iva-tc variables. 

@Override 

public void onCreate() { 

LocationListener listener = new LocationListener() { 

@Override 

public void onLocationChanged(Location location) { 

if (lastLocation == null) { |<f ii’s ou\r -Pivsi sei lasiLodatio^ io 

lastLocation = location; 七 k L-ot^\ov\- 


Cv-ca*tc *tV>C 


da*t F*«{1 
faklii 


Odometer 

Service.java 


distancelnMeters += location.distanceTo(lastLocation); 


lastLocation = location 


t • 

Add dis*td^e bc*tv/ccv> 七 his lotatioi^ "the 
las 七 *to 七 he d*is*ta^c|r>Mc*tcv-s variable, at\d set 
las*tLoda*t'ioy> *to duvvcy>*t Lodatioy>. 


@Override 

public void onProviderDisabled(String argO) {} 


V 


@Override 、 

心 〆^ y\tt& to ovcv\ridc these 
public void onProviderEnabled (String argO) {} … 七 hods, as 七 hyYe pad d 

/ "the LotBhov\L\sitv\cr 

@Override i/_ 

public void onStatusChanged(String argO, int argl, Bundle bundle) {} 


Now that we’ve created a listener, we need to register it with the location 
service. 
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register the location listener 


Registering the LocationListener 



Binder 

Location 

getMilesQ 


You register the location listener with the Android location service 
using a LocationManager object. A location manager gives you 
access to the location service, and you create one like this: 




7"V)is is Kow you 
Android lodatioy^ sc^rv^c. 


LocationManager locManager = (LocationManager)getSystemService(Context.LOCATION SERVICE) 


The getSystemService () method returns a reference to 
a system level service. In this case, we want to use Android’s 
location service, so we use: 


Wlc used -the gc-tSysicmScv-vidcO 
rweihod catrlic\r -to gei a^dcss -to 
A^dv-oid^s scv-vidc- 


getSystemService(Context.LOCATION SERVICE); 


Once you have a location manager, you can use its 
requestLocationUpdates () method to register the 
location listener with the location service, and specify criteria 
for how often you want the listener to get updated. The 
requestLocationUpdates () method takes four parameters: a 
GPS provider, the minimum time interval between location updates 
in milliseconds, the minimum distance between location updates in 
meters, and a LocationListener. 


Here’s how you’d use the method to get updates every second when 
the device has moved more than a meter: 

locManager.requestLocationUpdates(LocationManager.GPS PROVIDER, 


TWis is 今 PS frovid^r. 


1000' ^ - The "tirwC \ y \ miHisedo^ds. 


The distal m mc*tcvs. - 一 ■> 


listener) ; 


TWis is i\\t Lota-tio^L'istcncv- wc heated- 


We can use this in the Service onCreate () method to register 
the listener we created with the location service and make sure it gets 
regular updates. Here’s the code: 


QOverride 

public void onCreate() { 

LocationListener listener 




l/Ve -to sc-t up -the listchcv a^d vegistev \i wiih 
"the lodatior> sev-vite 七 he sev-vide is 匕 rea 七 ed. 


=new LocationListener() {...}; 


LocationManager locManager = (LocationManager)getSystemService(Context•LOCATION—SERVTGE)/ 
locManager.requestLocationUpdates(LocationManager.GPS PROVIDER , 1000, 1, listener); 


That’s everything we need to register the listener with the location 
service and get it to keep track of the distance traveled. Next, we need 
to get it to report back to the activity. 
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Tell the activity the distance traveled 

If you remember, there were two things we needed our service to 
do. 

The first thing we needed was to get it to keep track of the 
distance traveled by the device. We’ve now done this by creating a 
location listener and registering it with the location service. 

The second thing we need is to get the service to tell the activity 
how far the device has traveled so that it can tell the user. To do 
this, we’ll create a simple getMiles () method in the service 
that converts the current distance traveled into miles. The activity 
will call this method whenever it want to know the distance. 


getMilesQ 



The v>umbcv- o( miles *tvavclcd 


Here’s what the getMiles () method looks like: 

_TWis distal Raveled m 

^ mC *tcv-s *m*to miles. VVe Cov\A make 七 Wis 
daltula-tio^ more wc *to, 

but iVs a^duv-a-tc -for ou\T furfoscs. 


That’s everything we need for our OdometerService.java code. We’ll 
show you the full code on the next page. 


public double getMiles() { 

return this•distanceInMeters / 1609.344; 

} 

The method takes the current distance traveled in meters, then 
divides it by 1609.344 to get the distance traveled in miles. 
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OdometerService code 


The full OdomcterScrvicejava code 

Here’s the full code for our bound service OdometerService.java : 



Binder 

Location 

getMilesQ 


package com.hfad.odometer; 



import 

import 

import 

import 

import 

import 

import 

import 

import 


android.app.Service; 

android.content.Context; 

android.content.Intent; 

android.location.Location; 

android.location.LocationListener; 


Odometer 


HU 

app/sre/main 

L D 

java 


android.location.LocationManager; 


android.os.Binder; 
android.os.Bundle; 
android.os. 工 Binder; 



art all classes wcVc us'mj. 


com.hfad.odometer 

■ <Ut» F*If| 

r“iu …邊 

Odometer 

Service.java 


public class OdometerService extends Service { 


private final 工 Binder binder = new OdometerBinder(); 


private static double distancelnMeters; 
private static Location lastLocation = null 



• avc the pirivatc variables 


we \rc 


usmg. 


public class OdometerBinder extends Binder { 

OdometerService getOdometer () { \ 〜 cate a bou^d you 

return OdometerService.this; {p a B'mdcv- object l*b enables 

} *to bmd *to scv-v'idc. 

} 

QOverride 

public 工 Binder onBind ( 工 ntent intent) { 
return binder; 


This jets called wh ⑶七 he atiiviiy bmds -to ihc scvvidc. 
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The OdometerScrviccjava code (continued) 

@Override ^ '^1 

y/)icy\ scv*vifi.c is fi.vc3x.cd* 

public void onCreate() { 

LocationListener listener = new LocationListener() { 

@Override 

public void onLocationChanged(Location location) { 
if (lastLocation == null) { 
lastLocation = location; 

} 

distancelnMeters += location.distanceTo(lastLocation) 
lastLocation = location; 


□ 


Odometer 



app/sre/main 

- 7^1 




java 


com.hfad.odometer 

广 1 

Odometer 

Service.java 


This is ou\r irwplcmCh-ta*toh 
°*P "the lodatioh listchcv-. 


QOverride 

public void onProviderDisabled(String argO) {} 

QOverride 

public void onProviderEnabled(String argO) {} 


QOverride 

public void onStatusChanged(String argO, int argl. Bundle bundle) {} 



LocationManager locManager = (LocationManager)getSystemService(Context•LOCATION—SERVICE) 
locManager•requestljOcationUpdates(EocationManager•GPS—PROVIDER, 1000, 1, listener); 

Corwe\rt 七 he d'xsiaut Raveled Rtysicr *tKc lodatioh l'is*tcy>cv 

^ ^'Ics ar>d ii. 如狀 loda*t*ioy> scvv'idc- 

public double getMiles() { 、二 

return this•distancelnMeters / 1609.344; 


The code allows an activity to bind to it, and when asked, it tells 
the activity how far the device has traveled. There’s one more 
thing we need to do with our service; we need to give the app 
permission to use the GPS. 
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declare service 


Update AndroidMaHifest.xml 



Binder 

Location 

getMiles() 


When you create an app, Android allows you to perform most actions 
by default. But there are some actions that Android needs the user to 
give permission for in order for them to work correctly. One of these 
actions is using the device GPS. If your app needs to use the device 
GPS, the user needs to give permission when the app is installed. 


You tell Android that your app needs permission to use the GPS using 
the <uses-permission> element like this: 

〈manifest ... > 


1^/cVc ddd'rn^ tw»s because wcVc 
us'm(\ decide $PS m our aff. 


<uses-permission android:name="android.permission.ACCESS FINE LOCATION" /> 


〈 /manifest 〉 

If you don’t include this permission in AndroidManifest.xml, the app will 
crash. 

You also need to check that Android Studio has added your service to 
AndroidManifest. xml: 

〈manifest ... > 


<uses-permission android 




〈application 
… > 
〈activity 

參 _ • 

</activity> 


All scvvidcs heed -to be declared m 

A 灼 dv^oidM 如 


□ 


Odometer 


L a 


app/sre/main 

</ 


AndroidManifest.xml 

〈service 

android:name= M .OdometerService n 

sc*t*tn ^3 *tWis *to -false, 3 s or\ly 
七 Wis aff wlluse 七 he service. 


android: exported:'▼ false” 
android:enabled: n true” > 
</service> 


</application 〉 
〈 /manifest 〉 


The android: ⑶ abled a^tbribu 七 e mus-t ci-thcv be sci 
■to o\r omiiicd domplcicly. {( you sci \i io 
•false, you\r app wo〆 七 be able -to use -the sevvide- 


Let’s revisit where we’ve got to with our app after an exercise. 
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Service Magnets 

See if you can complete the code below to create a bound service 
called Number Service that returns a random number when its 
getNumber () method is called: 


public class Numberservice extends Service { 

private final IBinder binder = new NumberBinder(); 
private final Random random = new Random(); 

public class extends Binder { 

.getNumberService() { 

return NumberService.this; 


@Override 

public (Intent intent) { 


public int getNumber() { 

return random•nextlnt(100); 

TV^is toAt a v-a^dom number. 



binder | 


NumberBinder 
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magnets solution 



Service Magnets Solution 

See if you can complete the code below to create a bound service 
called Number Service that returns a random number when its 
getNumber () method is called. 


public class NumberService extends Service 


private final 工 Binder binder = new NumberBinder(); 
private final Random random = new Random(); 


public class 



extends Binder 


getNumberService() 
return NumberService.this; 


QOverride 


Ovcv-vidc method so 

ad*tw*i*ty da 的 bmd *to scwidc- 


Pc-f'mc a Kumbcv-B'mdcv- tUss 
■bV^a-t B’mder. 

^ 一 • 丁 k activity heeds -to 
grt 3 \TC-Pc\rChdC io the 
Numbc\rSc\rVulc the 

Bihdcv, so i-t heeds -to v-ctuv-h 
a WurhbcirScv-vidc object 



public 


IBinderl I onBindI 


(Intent intent) 



binder 〕 卜 The ohBihdO method should \rctuv-h the Bihdcv. 


public int getNumber() { 

return random•nextlnt(100) 





d*id^*t Y\ttd *fco use -these mayrb. 



I onHandlelntent 
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Where we've got to 

Let’s look again at what we want our app to do so we can see 
what’s left: 



MainActivity binds to OdometerService. 

MainActivity uses the OdometerService getMiles () 
method to ask for the number of miles traveled. 



The OdometerService uses the Android location services to 
keep track of when the device moves. 

It uses these locations to calculate how far the device has traveled. 



The OdometerService returns the distance traveled to 
MainActivity. 

MainActivity displays the distance traveled to the user. 



activity—main.xml 


Wll update the 
activity hcxt. 



o getMilesQ 


o 


1.11 





Android 

Location 

Service 


TV^'iS IS y\OY/ domflctc- 


MainActivity.java 


OdometerService.java 


So far we’ve created the OdometerService. It uses the 
Android location services to track locations, and uses this to 
calculate the distance traveled. 

The next thing we need to do is create MainActivity. We 
need to get it to bind to OdometerService, and then use 
the OdometerService getMiles () method to display the 
distance the device has traveled. 
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display miles 


Update MaiwActivity's layout 

We need to get MainActivity to use the service to display 
the number of miles traveled, so we’ll start by updating the 
layout file activity—main.xml. We’ll add a text view to the layout 
that we can use to display the mileage. We’ll update the text 
view every second in our Java code. 

Here’s the code for activity—main.xml\ 


Bind to Service 
Display miles 


T 7 

These a\rc i\)t ihih3s we 
Med *to do "to 


<RelativeLayout xmlns : android:'▼ http://schemas.android.com/apk/res/android" 

xmlns : tools= n http://schemas.android.com/tools" p — ^ 

android : layout width="match parent" - > 

- Odometer 

android : layout_height= M match_parent" | 「— | 

tools: context=M .MainActivity"> app/^Miain 

<TextView android: text= n '▼ 

android : id= n @+id/distance" 

android : textAppearance="?android:attr/textAppearanceLarge 
android : layout—width= n match_parent n 
android : layout 一 height= n match_parent n 
android : layout_centerHorizontal="true" 
android : singleLine= n false 
android : textSize= n 60dp n /> 

</RelativeLayout> I/Vcll iaSC 


L C3 

layout 




activity_ 

main.xml 


•to display 


Next, we need to update the activity code so that it binds to 
the service and updates the text view. We already know how 
to update views, but what we don’t know is how to bind to the 
service. Let’s see how it’s done. 
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services 


Create a ServiceCowwectiow 


Earlier on in the chapter, we said that an activity binds to a service 
using a ServiceConnection object. A ServiceConnection 
is an interface with two methods: onServiceConnected () and 
onServiceDisconnected(). 

The onServiceConnected () method is called when a connection 
to the service has been established and a Binder object is received 
from the service. You can use the binder to get a reference to the service. 

The onServiceDisconnected () method is used when the 
connection to the service has been lost. 

When you need an activity to bind to a service, you need to create your 
own implementation of the ServiceConnection. Here’s ours: 



Main 

Activity 


Service 

Connection 


Odometer 

Service 


□ 


Odometer 


public class MainActivity extends Activity { 

〆 l/\/c II use tV^'is -fov i\\t 

private OdometerService odometer; Odomctcv'Scvv'idc. 

private boolean bound = false; ^ Msc this ^ whether o, the 


L n 

app/sre/main 

-Hi 


activity s bouhd -fco the scvvidc. 


java 

L n 

com. hfad.odometer 

o 

Main 

Activity.java 


private ServiceConnection connection = new ServiceConnection() { 

@Override 

public void onServiceConnected(ComponentName componentName, IBinder binder) { 

OdometerService.OdometerBinder odometerBinder = 

(OdometerService.OdometerBinder) binder; 

odometer = odometerBinder.getOdometer(); ^ ^ 

^ ^ , ^Cast the Bmdcv- io 

bound - tru & Odo^i^d^ use -to a 

@Override 试七 bouy>d to tvuC- 

public void onServiceDisconnected(ComponentName componentName) { 
bound = false; 

} r 

l/VVh the sevvide is disdohhedted, 
set bouhd "to -false- 


When the service is connected, the onServiceConnected () 
method uses the Binder object to get a reference to the 
service. We’re also using the onServiceConnected () and 
onServiceDisconnected () methods to record whether the 
service is currently connected. 
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bind and unbind 


Piwd to the service whew the activity starts 



Bind to Service 
Display miles 


We’re going to use the connection to bind to the service when the 
activity becomes visible. As a reminder, when an activity becomes 
visible, its onStart () method gets called. 

To bind to the service, you first create an explicit intent that’s 
directed at the service you want to bind to. You then use the 
activity’s bindService () method to bind to the service: 

MainActivity OdometerService 

@Override 



protected void onStart() { 

super.onStart(); 

Intent intent = new Intent(this 
bindService(intent, connection, 


TWis is a 於 \v\itY\i dWtdtd 
^ -to 

OdometerService.class); 

Context.BIND AUTO CREATE); 


The code Context. BIND AUTO CREATE tells Android to 




This uses the ihtcht ay\d sc\rvidc (iohhc^ioh 
"Co bihd the activity "to the scv-vidc- 


create the service if it doesn’t already exist. 


Uwbiwd from the service when the activity stops 

When the activity loses visibility, we’re going to unbind from the 
service. When an activity loses visibility, its onStop () method gets 
called. 


You unbind from the service using the unbindService () 
connection. The method takes one parameter, our connection. 
We’re going to check whether the service is bound when the activity 
loses visibility, and if it is, we’ll unbind it: 


0^0 

MainActivity OdometerService 


@Override 

protected void onStop() { 

super. onStop () ; 丁 iVis uses 七 scv~vidc £.oy>ir>Cd*t,ioh 

if (bound) { ^ -fvom sevv/i 匕 e. 

unbindService(connection); 
bound = false; 


So far we have an activity that binds to the service when the activity 
starts, and unbinds from the service when the activity stops. The 
final thing we need to do is get the activity to ask the service for the 
distance traveled. 



com. hfad.odometer 


ilatt 

Main 


Activity.java 
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display the distance traveled 




services 

Bind to Service 
Display miles 


Once you have a connection to the service, you can call its methods. 
We’re going to call the Odometer Service getMiles () 
method every second to get the distance traveled, and then use it 
to update the text view in the layout. We’ll call the getMiles () 
method every second and update the text view each time it’s called. 

To do this, we’re going to write a new method called 
watchMileage () . This works in exactly the same way as the 
runTimer () method we used in Chapter 4. The only difference 
is that it displays miles traveled instead of elapsed time. 

Here’s our watchMileage () method: 


16:19 


1.11 miles 


TKc a£.*tw>*ty >w»ll use 

method m OdomC*tc\rScvv*itC *to 

fofula*tc *tV>c Tcx.*t\/ic>w- 


private void watchMileage () { 


6\ti the viev/. 


final TextView distanceView = (TextView)findViewByld(R.id.distance); 
final Handler handler = new Handler () ; ^ — Cxtd^t 3 Handler- 


handler, post (new Runnable () { ^Call Ihc fostO w 七 hod, fdssi^ m a Ru^ablc. 

@Override 


public void run() { 

double distance = 0.0; 
if (odometer != null) { ^ 

distance = odometer.getMiles(); 


|-f d *to *tV>c 0domc*tcv"Scv - vidc> 

use *i*U 5C*tM»lcsO method. 


Fov-r^a-t "the miles. 

} 

String distanceStr = String, format ( M %1$, .2f miles ， ' ， distance); 

distanceView.setText(distancestr); __ 

handler.postDelayed(this, 1000); L_J 

々 Odometer 

Post 七 he dodc m Ruvmable *to be via 灼 a-ftev- d delay o( IL 40 

1,000 m'lll'isedo^diS) or I stCov\d- As tK'is I'mc o( Code is mdludcd m tKc app/sre/main 
} Ru^dble \ruy>0 method, rt Will \r ⑽ cvc\ry sttoY\d (v /狀 a s\\o^i la^)- 

java 

We’ll then call this method in the activity’s onCreate () method 
so that it starts running when the activity gets created: 


}) 


@Override 

protected void onCreate(Bundle savedlnstanceState) 


—Z 1 


com.hfad.odometer 


山 " FmA 


Main 
Activity.java 


watchMileage(); 


We’ll show you the full code for Main Activity on the next page. 
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MainActivity code 


The full MaiwActivity.java code 



Bind to Service 
Display miles 


Here’s the complete code for MainActivity.java : 


package com.hfad.odometer; 


import android.app.Activity; 

import android.content.ComponentName; 

import android.content.Context; 

import android.content • 工 ntent; 

import android.content.ServiceConnection; 

import android.os.Bundle; 

import android.os.Handler; 

import android•os • 工 Binder; 

import android.widget.TextView; 


public class MainActivity extends Activity 


□ 

Odometer 



app/sre/main 



com.hfad.odometer 



Main 


Activity.java 


^ lA/c II use tWis ^ 

private OdometerService odometer; ^ 

private boolean bound = false; Use this -fco s-fcov-c whethev- ov y\o-t ihc 

a^tivrty’s bouhd {jo "the scv-vidc- 

private ServiceConnection connection = new ServiceConnection () { 

@Override 


Wc r\ttd bo 
dc-f me a 

ScV"VidcCoir>lr>Cd*tlOir>. 


<r 


public void onServiceConnected(ComponentName componentName, IBinder binder) { 
OdometerService.OdometerBinder odometerBinder = 


(OdometerService.OdometerBinder) binder; 


odometer = odometerBinder.getOdometer(); 
bound = true; 

} 

@Override 


a -to 七 he 

Odorwcic\rSc\rvidC when ihc 
sev-vite is Coy\Y\tt{,td- 


public void onServiceDisconnected(ComponentName componentName) { 

bound = false; 


QOverride 

protected void onCreate(Bundle savedlnstanceState) { 


super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity main); 


watchMileage() 


Call "Bie v/a*tdhMilcajcO -Pu^d-tior> -the a^tivrty’s dv-caicd- 
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The MaiwActivity.java code (contmued) 


QOverride 

protected void onStart() { Bmd sev-vide ^i\\tY\ ad*tWrty s*tav*ts. 

super.onStart(); 

Intent intent = new 工 ntent(this, OdometerService.class); 
bindService(intent, connection, Context.BIND AUTO CREATE); 


Wnbmd -the sc\rvidc when ihc a^iviiy s-fcops. 

@Override 々 

protected void onStop() { 

super.onStop(); 
if (bound) { 

unbindservice(connection); 
bound = false; 


This method updates i\\t mileage 七 hat’s displayed- 

vr 


□ 

Odometer 

L Q 

app/sre/main 


java 

MU 

com. hfad. odometer 

cUt* F*«{| 

Main 

Activity.java 


private void watchMileage() { 

final TextView distanceView = (TextView)findViewByld(R.id.distance); 
final Handler handler = new Handler(); 
handler.post(new Runnable() { 


QOverride 

public void run() { 

double distance = 0.0; 
if (odometer != null) { 




l-p Wvc 5o*t a bo *tKc 

Odomc-tcvScvv'idc, use its ytMilcsO method. 


distance = odometer.getMiles(); 

} 

String distanceStr = String . format ( "%1$, .2f miles ， ' ， distance); 
distanceView.setText(distanceStr); 
handler.postDelayed(this A 1000); 


})； 


Update i\\t A\siaut cvc\ry sttoY\A- 


That’s all the code you need to get MainActivity to use the 
OdometerService. Let’s see what happens when you run the code. 
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what happens 


What happens when you ruw the code 

Before you see the app up and running, let’s go through what 
happens when the code runs: 



Bind to Service 
Display miles 



When the MainActivity starts, the onStart() method creates a 
ServiceConnect ion. 

It asks to bind to the Odometer Service. 


o 一 o 

MainActivity ServiceConnection 



The OdometerService starts and its onBind() method is called with a 
copy of the intent from the MainActivity. 



Intent 



Intent 


MainActivity 


ServiceConnection 



onBindQ 


OdometerService 



The onBindQ method returns a Binder object. 


o 

MainActivity 


Binder 



onBindQ 


ServiceConnection 


OdometerService 
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The story continues 


services 



MainActivity gets a reference to OdometerService from the Binder 
and starts to use the service directly. 


getMilesQ 




While MainActivity is running, the watchMileage() method calls the 
OdometerService getMiles() method every second and updates the 
screen. 


watchMileage() 



MainActivity Layout 



When MainActivity stops, it disconnects from the OdometerService 
by calling unbindServiceQ. 



Let’s run the app and see what it does. 
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test drive 

K 




Test drive the app 




Bind to Service 
Display miles 


To see the app in action, you’ll need to run it on a device that has a 
GPS. If you don’t, the app won’t work. 

When you start the app, it says the distance traveled is 0 miles. An 
icon appears at the top of the device indicating that the location 
service has been activated: 




The location scv-v'itc is 



16:16 


Tk app stav-b M - \ 

displaying 0.00 miles. 


0.00 miles 

This may uf 

sl^K-tly you s*tav*t *tV>c 
af>p. This is because *i*t *tak« 
a -rev/ sttov\As -fov 

*to ilomC \Yk OY\ dcvidc 

3v>d i*t 
m*isvcfo\rt it 



16:19 


1.11 miles 


I^Vhch you take youv- device 
•Po\r a walk, -the dis^hde 
displayed ih^v-cascs. 


When you take your device on a road trip, the 
distance traveled increases. 



We fciow you’re full of great ideas for 
improving ihe Odometer 啦 ， So A^iy not 
tryAem out? As an example，not try 
adding Start, Stop, and Reset buttons? 
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Your Android Toolbox 

You’ve got Chapter 13 under 
your belt and now you’ve 
added services to your toolbox. 


You c^y\ download 
-full code ^OV 

Wt 切 

HcadPtv-stA^dvoid. 




BULLET POINTS 


■ A service is a component that can perform 
tasks in the background. It doesn’t have a user 
interface. 


■ 


■ 


■ 


■ 


A started service can run in the background 
indefinitely, even when the activity that started 
it is destroyed. Once the operation is done, it 
stops itself. 

You declare services in AndroidManifest.xml 
using the 〈 service 〉 element. 

You can create a simple started service by 
extending the 工 ntentService class and 
overriding its onHandleintent () method. 
The 工 ntentService class is designed for 
handling intents. 

You start a started service using the 

startService () method. 

If you override the 工 ntentService 
onStartCommand () method, you must 
call its super implementation. 

You create a notification using a notification 
builder. You get your notification to start an 
activity using a pending intent. You then use 
Android’s notification service to display the 
notification. 

■ A bound service is bound to another component 
such as an activity. The activity can interact with 
it and get results. 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


■ 


You usually create a bound service by extending 
the Service class. You must define your own 
Binder object, and override the onBind () 
method. This is called when a component wants 
to bind to the service. 

The Service onCreate () method is 
called when the service is created. Use it for 
instantiation. 

The Service onDestroy () method 
is called when the service is about to be 
destroyed. 

You can use the Android location service to get 
the current location of the device. You create a 
LocationListener, and then register it 
with the location service. You can add criteria 
for how often the listener is notified of changes. 
When you use the device GPS, you need to add 
a permission for it in AndroidManifest.xml. 

To bind an activity to a service, you create a 

ServiceConnection. You override the 
onServiceConnected () method to get 
a reference to the service. 

You bind to the service using the 
bindService () method. You unbind from 
the service using the unbindService () 
method. 


CHAPTER 13 
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14 material design 


^ Living in a Material World ♦ 



One T 卜 

player comes off 
the pitch, another player 
moves straight in. Just 
i like a recycler view. 


With API level 21, Google introduced Material Design. 

In this chapter, we’ll look at what Material Design is, and how to make your apps fit in 
with it. We’ll start by introducing you to card views you can reuse across your app for a 
consistent look and feel. Then we’ll introduce you to the recycler view, the list view’s 
flexible friend. Along the way, you’ll see how to create your own adapters, and how to 
completely change the look of a recycler view with just two lines of code. 


this is a new chapter 597 



material design 


Welcome to Material design 

Material Design was launched with API level 21 and it’s 
intended to give a consistent look and feel to all Android apps. 
The idea is that a user can switch from a Google app like the 
Play Store to an app designed by a third-party developer and 
instantly feel comfortable and know what to do. The Material 
part of the name comes from Material Design’s visual style, 
which makes the parts of your interface look like overlapping 
pieces of material or paper: 



13:38 


Pizzas 


Material Design uses animation and 3D effects likes drop- 
shadows to make it clear to the user how they can interact with 
the app. To do this, Material Design includes a set of support 
libraries that contains different widgets and themes for use in 
Material Design apps. In this chapter, we’ll take a few of these 
widgets and use them to make the Pizza app we developed in 
Chapters 9 and 10 fit in with Material Design. 
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CardViews and RGcycIcrVicws 

Two of the most important Material Design widgets are recycler views 
and card views. 

A card view is a container for other views. Card views have rounded 
corners, and a drop-shadow that makes them appear to be floating above 
the background. You can animate a card view so that it will appear to 
move when you push it. 

A re cycler view is like a new kind of list view A recycler view gets 
its name because it can efficiently reuse (or recycle) views to create the 
appearance of a list on the screen. A re cycler view can be used to display 
card views. 

We’re going to change the Pizza app so that it uses card views and recycler 
views. We’ll convert the app so that the list of pizzas goes 


from this: 


This is S ho\rr»^| — > 
Listl/icw. 


to this: 




TWis is a 

view 灼 3 

■Uo dav-d views. 
EatK card view 
wta’ms 

o( a 


Gee} B!^ - 

Material Design uses a lot of 3D 
effects. But doesn’t this slow 
your device? On most devices, 
the answer is no. If possible, the 
Material views will try to use the 
power of the graphics hardware 
to generate the drop-shadows 
in much the same way that a 
game would. That means that 
not only are generated shadows 
rendered beautifully, but they 
also take no extra time to draw. 
On older devices, the views will 
insert shadow images behind 
each view. That will take a little 
extra processing power and some 
extra memory. If you want to run 
your app on a very old device, it’s 
best to check it against an actual 
device before release. 
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pizza again 


The Pizza app structure 


We’re going to change the app so that we use a card view and 
recycler view for the list of pizzas. Here’s a breakdown of how the 
app will be structured and what it will do: 


o 

o 

o 


When the app gets launched, it starts Main Activity. 

The activity uses layout activity—main.xml and has a navigation drawer. When the user clicks on 
one of the options in the navigation drawer, it displays the appropriate fragment. 

When the user clicks the Pizzas option, it displays PizzasMaterialFragment. 

Piz zasMa ter ial Fragment contains a re cycler view. 

PizzaMaterialFragment uses an adapter, CaptionedlmagesAdapter, to display 
card views showing an image and caption for each pizza. 

The card views are defined in card—captioned—image.xml. Pizza data is held in Pizzas.java. 


o 

o 


When the user clicks on a pizza, details of the pizza are displayed in 
PizzaDetailActivity. 

When the user clicks on the Create Order action in the action bar of 
MainActivity or PizzaDetailActivity, Order Activity is displayed. 


Mos*t o( 3V"C 
-files you 
dl^ddy we 
七 *to 



Device 




activity—main.xml 





Top 
Fragment.java 


: Layout! 

: /Layout* 


fragment 

top.xml 



Pasta 

Fragment.java 


MainActivity.java 



Captionedlmages 

Adapter.java 


card— 

captioned, 

image.xml 


activity—order.xml 


: Layout) 

: /Layouil 


:o 灰 


PizzaMaterial 

Fragment.java 


PizzaDetail 

Activity.java 




activity—pizza_ 
detail.xml 


heed -to add 
these -to the 
cxistmg pvojct-t. 


Pizzas.java 
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Add the pizza data 

We’ll start by adding the pizza images to the Bits and Pizzas project. 
Download the files diavolo.jpg and funghi.jpg from https://tinyurl.com/ 
HeadFirstAndroid. Then drag them to the folder app/sre/main/res/drawable- 
nodpi. If Android Studio hasn’t created the folder for you, you’ll need to 
create it. 

We’re putting the images in the drawable-nodpi folder because we want the 
device to use the same images, regardless of the dpi of the screen. If you 
wanted, you could create separate images for different device resolutions 
and put them in the appropriate drawable^ folder. 

Add the Pizza class 



We’re going to update the 
Pizza app in this chapter, 
so open your original 
Bits and Pizzas project in 
Android Studio. 


We’ll add a Pizza class to the app which the re cycler view will get its ^― 
pizza data from. The class defines an array of two pizzas, where each 
pizza is composed of a name and image resource ID. Add the class to the 
com.hfad.bitsandpizzas package in the app/sre/main/java folder 
in your project, giving it a class name of Pizza. Then save your changes: 


|的 a veal app ； wc 你 i^rb use a 

dd'tdbdse -rov- 七 his. WcVc d 
Java dlass -Pov- simplidi-ty. 


package com.hfad.bitsandpizzas; 


public class Pizza { _Piz^a has a vcsouvdc 

private String name; <： ^ ( p. JKc IP v-^cv-s *to 

private int imageResourceld;^ ^ ^ ^ ^ aboVC . 


public static final Pizza[] pizzas = { 

new Pizza("Diavolo", R.drawable.diavolo), 


new Pizza("Funghi M , R.drawable.funghi) 




The Pizza do^siv-ud-fcov- 


private Pizza(String name , int imageResourceld) { 


this.name = name; 


this.imageResourceld = imageResourceld; 


public String getName() { 

return name; Tiicsc 3v*c ^c*t*tcv*s (or 

} / fv*iva*tc vav-*iablcs. 




public int getImageResourceld() { 
return imageResourceld; 


□ 

BitsAndPizzas 

L Q 

app/sre/main 

L Clb 


java 



com.hfad.bitsandpizzas 

o 

Pizza .java 


We’re going to use a recycler view and card view in the app, and these 
require support libraries. We’ll add these next. 
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Add the support libraries 


Card views and recycler views 
come from the GardView and 
Re cycler View v7 libraries, so 
we need to add these libraries 
as dependencies. To do this, go 
to File^Project Structure. In 
the Project Structure window, 
select app and switch to the 
Dependencies tab. Then 
add library dependencies for 
recyclerview-v7 and cardview-v7. 


©GO 


Project 'Structure 


Properties Signing Flavors BuiiEd Types 


Dependencies 


SDK Location 
Project 

— Modules — 


{d【r=Jbs, include=[*.Jar]} 


com.android.support:appcompat-v7:Z 1.0.+ 
cotn.antfroi£j.supportLr0cyclerview-v7:Z 1.0.+ 
com.aridroi(i.support:carcJview-v7:Z 1.0.+ 

t 

TV^C *t^csc support 

libraries as 


SCOp€ 


Compile 

Compile 

Compile 



When you add dependencies, Android Studio records them in the app/ 
build.gradle file: 


dependencies 

compile 

compile 

compile 

compile 


f ileTree (dir : 'libs', include : [ 、 *.jar /r ]) 

'com.android.support : appcompat-v7:21.0•+' 
'com.android.support : recyclerview-v7:21•0. 
'com.android.support : cardview-v7:21.0. 



f\dd\v\(^ suffovt libraries *to 
y/mdov/ dbovc ufdS'tcs 
build ^ddle bcWmd 

□ 

BitsAndPizzas 

L u 


If you wish, you can manage the library dependencies for your app 
by editing this file directly. It will have the same effect as adding 
dependencies in the Project Structure window. 

Now that you’ve added the support libraries, we’ll create the card view. 



build.gradle 
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Create the CardView 


You use card views to visually represent the basic data items in your app in 
a recognizable and coherent way. The basic data items in our Pizza Shop 
app are pizzas, pasta, and stores, so we’re going to create a card view we 
can use to displays these items. 

You create a card view by including it in a layout. You can either add it 
to an existing layout, or create a new layout file for it. Creating a new 
layout file for the card view means that you can use the card view inside a 
recycler view. 

We want to use the card view inside a re cycler view, so we’re going to put 
it in its own layout file. To do this, add a new layout file to the app/src/ 
main/res/layout folder called card_ captioned_ image, xml. 


You define a card view using code like this: 




This adds {Mt Cavd\/*ic>w. 



<android.support.v7.widget.CardView 

xmlns : android: n http://schemas.android.com/apk/res/android" 
xmlns : card_view= M http : //schemas.android.com/apk/res-auto" 
android: id= n @+id/card—view，’ 
android: layout_width="match_^parent M 
android:layout_height= M 200dp n 
android:layout_margin= M 5dp" 
card view:cardCornerRadius= M 4dp n > ^ 


□ 


r 

Cav-d\/ic>w 
a subclass o-f 
Fv-amcLayout 


BitsAndPizzas 


</android.support.v7.widget.CardView 〉 


This gives the 

Cav-dl/icw 

v-ouhded 

^ov-hC\rs. 


L Q 

app/sre/main 


□ 


res 


The CardView class comes from the v7 CardView support library, so 
we have to use its full class path of android. support. v7 . widget. 
CardView. 

You give your card view rounded corners by adding a namespace of 

xmlns : card view="http : //schemas.android.com/apk/res-auto' 


layout 

I <%ml> j 
<AmlI 

card_captioned_ 

image.xml 


and using the card_view : cardCornerRadius attribute to set the 
corner radius. As an example, the code 

card—view:cardCornerRadius="4dp" 

sets the card corner radius to 4dp. 

You define the appearance of the card view by adding other views to 
it. In our case, we want to display an image and text in the card view. 
We’ll show you the full code on the next page 
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card_captioned_image code 


The full card_captiowcdJmage.xml code 


Here’s the full code for card—captioned—image.xml (weVe added a linear 
layout to the card view, and put an image view and text view inside the 
linear layout; we’ve taken this approach because the CardView class 


extends the FrameLayout class, and frame layouts are designed to hold 
a single child view — in this case, the frame layout has a single child view of 
a linear layout): 


□ 


BitsAndPizzas 


<?xml version= n l.0 M encoding= n utf-8 n ?> 

<android.support.v7.widget.CardView 

xmlns : android:’▼ http://schemas.android.com/apk/res/android" 
xmlns : card_view= M http : //schemas.android.com/apk/res-auto" 
android : id= n @+id/card_view" 
android : layout__width= n match_parent" 
android: layout 一 height= n 200dp n view y/'ill be as Y/idc as its 

android : layout_margin= M 5dp M 
card view:cardCornerRadius= M 4dp n > 


L D 

app/sre/main 


dllov/S) air\d 2-00 



res 


MU 

layout 




card_captioned. 

image.xml 


<LinearLayout 

android : layout_width= M match_parent" 
android : layout—height= n fill_jparent n 
android:orientation="vertical n > 

<ImageView android : id= n @+id/info 一 image 
android : layout_height= M Odp" 
android : layout_width= M match_parent 
android : layout_weight= M 1.0" 
android : scaleType= n centerCrop"/> 

<TextView 

android : id= n @+id/info_text" 
android : layout—marginLeft= n 5dp" 
android : layout_marginBottom="5dp 
android : layout_height= n wrap—content 
android : layout_width="match_parent n /> 
</LinearLayout> 

</android.support.v7.widget.CardView 〉 


The irway v/ill be as wide as 
•rts allows. WcVc 

{p make suve 七 he 
sddlcs u^i-Pov*nr\|y. 



We’ll be able to use this card view layout for any data items that consist of 
a caption and an image, such as our pizza data. 

The next thing we need to do is create a recycler view that will display a 
list of our card views. 
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RGcycIcrVicws use RecyclGrView.AdaptGrs 


A recycler view is a more advanced version of a list view. Just like a list view, 
a re cycler view is a scrollable container used for displaying sets of data. A 
recycler view, however, is more efficient at displaying large data sets. This is 
because a re cycler view reuses (or recycles) views when they are no longer 
visible on screen, whereas a list view displays a new view for each item that 
appears on screen. 

Just like a list view, you add data to a recycler view using an adapter. 
Unfortunately, recycler views don’t work with any of the built-in adapters 
such as array adapters or cursor adapters. Instead, you have to create your 
own that’s a subclass of the RecyclerView. Adapter class. 


The 

uses 


the ad 


lev- view 




Recycler 

View 


> 


Adapter 


r 

you v/v-iic i\\t adap*tcv you\rscl-f. 


Data 


T\\t adapW uses 
i\\t data you 

^ 一- 、 1^ o 讲 

dasC) ili'is Vill be 
da*ta -f \rom 
tlass. 


The adapter has two main jobs: to create each of the views that are visible 
within the recycler view, and to configure the view to match a piece of 
data. 


In our case, the recycler view needs to display a list of cards, each 
containing an image view and a text view. This means that the adapter 
needs to create views for these items, and replace their contents when each 
item in the data set is no longer visible. 

Over the next few pages, we’re going to create a recycler view adapter. We 
need it to do three things: 


o 

o 

o 


Specify what type of data the adapter should work with. 

We need to tell the adapter to use card views. Each card view needs to 
be populated with an image and its caption. 

Create the views. 

The adapter needs to create all of the views that will need to be 
displayed on screen. 

Bind the data to the views. 

The adapter needs to populate each of the views with data when it 
becomes visible. 


We’ll start by adding a RecyclerView. Adapter class to our project. 
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Create the basic adapter 

We’re going to create a re cycler view adapter called 
CaptionedlmagesAdapter. Create a new class called 
CaptionedlmagesAdapter，then replace the code with the following: 

package com.hfad.bitsandpizzas; 

import android, support.v7 .widget.RecyclerView; dlass m a su’t lil ) 啊 

import android.view.ViewGroup; 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter.ViewHolder>{ 
//Provide a reference to the views used in the recycler view 
public static class ViewHolder extends RecyclerView.ViewHolder { 

//Define the view holder ^ ^ ^ ^ ^ ^ 

} I/Vcll do -this oy\ ihc page. ■! 


BitsAndPizzas 


@Override 

public CaptionedlmagesAdapter.ViewHolder onCreateViewHolder( 

ViewGroup parent, int viewType){ 

//Create a new view 

> Y 

You Y\ctd *to implement these mC*tV>ods. 

@Override ^ 

public void onBindViewHolder(ViewHolder holder, int position){ 
//Set the values inside the given view 


L L3 

app/sre/main 

~Z3 


java 


二 I 


com.hfad.bitsandpizzas 

Captionedlmages 

Adapter.java 


Y°^ 你的七 irwpIcrwCht 七 his rweihod boo. 
@Override 〆 

public int getltemCount(){ 

//Return the number of items in the data set 

} 


As you can see, the CaptionedlmagesAdapter extends the 
RecyclerView. Adapter class and implements its get ItemCount (), 
onCreateViewHolder (), and onBindViewHolder () methods. 

The getltemCount () method is used to return the number of items 
in the data set, the onCreateViewHolder () method is used to create 
the views, and the onBindViewHolder () is used to set the values inside 
the views. You must override these methods whenever you create your own 
recycler view adapter 

The class also defines a view holder, which you use to say what data the 
adapter should work with. We’ll look at this next. 
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Pefiwc the adapter's ViewHoldcr 

A view holder provides a reference to the view or views for each 
data item in the recycler view. It’s a holder for the views you want 
to display. 


When you create a re cycler view adapter, you need to create 
a view holder inside the adapter. You do this by extending the 
RecyclerView. ViewHolder class, and specifying what type 
of data it should hold. 

Each data item in our re cycler view is a card view, so we need to 
make our view holder store card views. Here’s the code: 

package com.hfad.bitsandpizzas; 


h l/icv/ttoldcv- holds 


oy\t o\r rwo\rc \/icws. 





^"lowHoldcv- doy>*ta'ms a 


import android.support.v7.widget.CardView; 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter.ViewHolder>{ 
/ /Provide a reference to the views used in the recycler view 
public static class ViewHolder extends RecyclerView.ViewHolder { 


private CardView cardView; 
public ViewHolder(CardView 


super(v); 
cardView = v; 



□ 


BitsAndPizzas 


Ouv vctydlcv- v*ic>w y>ccds *to display Cav-dViows, 
so y/e spcdi-fy 七 ha 七 oiaV* ^icv/ttoldcv- dorrta.ms 
Cav-d\/*ic>Ms. l-f you bo display av>o*tKcv 七 yP c 
o( da*ta \v\ vcdytlcv- viev/, you rt hcvc. 


When you create a view holder, you must call the ViewHolder 
super constructor using: 


app/sre/main 


java 


com.hfad.bitsandpizzas 

f“li■ 

o 

Captionedlmages 

Adapter.java 


super(v); 


This is because the ViewHolder superclass includes metadata 
such as the item’s position in the re cycler view, and you need this 
for the adapter to work properly. 

Now that we’ve created a view holder to store card views, we’ll get 
the adapter to display the card views in the recycler view. 
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Create the ViewHoldcrs 

The re cycler view maintains a fixed set of view holders that contain 
the views that appear in the list on the screen. The number of view 
holders depends on the size of the screen they need to appear on, 
and how much space each item takes up. To enable the re cycler view 
to figure out how many view holders it needs to maintain, you need 
to tell it which layout to use for each view holder in the adapter’s 
onCreateViewHolder () method. 

When the recycler view is first constructed, it builds this set of view 
holders by repeatedly calling the adapter’s onCreateViewHolder () 
method until all the view holders it needs have been created. The 
onCreateViewHolder () method takes two parameters: the 
ViewGroup parent object (the re cycler view itself) and an int 
parameter called viewType. This is used if you want to display 
different kinds of views for different items in the list. 

We want to create view holders that contains a card view based on our 
card_captioned_image.xml layout. Here’s the code that will do that: 


import android.view.Layoutlnflater; 

class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter•ViewHolder>{ 





@Override 

public CaptionedlmagesAdapter.ViewHolder onCreateViewHolder( 

ViewGroup parent, int viewType){ 

CardView cv = (CardView) LayoutInflater.from(parent.getContext()) 
.inflate(R.layout.card captioned image, parent, false); 


BitsAndPizzas 

413 

app/sre/main 


java 



return new ViewHolder (cv); 


layout -to use -fov- i\\t 

V'icv/ttoldcv-. 


com.hfad.bitsandpizzas 

■ t\u* f*T{J 

o 

Captionedlmages 

Adapter.java 


Now that the adapter can create the view holders in the re cycler view, 
we need to get the adapter to populate the card views they contain with 
data. 
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Each card view displays m image and a caption 


Each time the user scrolls the re cycler view and a new item appears, the 
recycler view will take one of the view holders in its pool and call the 
onBindViewHolder () method to bind data to its contents. The code 
in the onBindViewHolder () method needs to set the contents of the 
views in the view holder so that they match the data. 

In our case, the view holder contains card views that we need to populate 
with images and captions. To do this, we’ll add a constructor to the 
adapter so that the recycler view can pass data to it. We’ll then use the 
onBindViewHolder () method to bind the data to the card views. 

Create the constructor 

The re cycler view needs to pass arrays of captions and image IDs to the 
adapter, so we’ll add a constructor that will take these as parameters. 
We’ll store the arrays in instance variables. We’ll also use the number of 
captions passed to the adapter to determine the number of items in the 
data set: 



Cav-dl/icw doh-tdihs a 

Wt heed 

■to populate these With the (lap-tioh 
ir^ajc piz^a. 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter•ViewHolder>{ 


private String[] captions; 

private int[] imagelds; VJtW use *t^csc vandbles 

bo iiold -tiic data- 


□ 


BitsAndPizzas 


L d 

app/sre/main 


public CaptionedlmagesAdapter(String[] captions, int[] imagelds){ 


this.captions = captions; 
this.imagelds = imagelds; 


II pass the daia io the 

adaptev* us'mg its dohstv-u^-tov-. 


@Override 

public int getltemCount(){ 

return captions. length; ^ 

} ^urwbcv 


of i\\t a^ay equals 

)C\r o-P ddid liems m i\\t view. 


java 

LQ 

com.hfad.bitsandpizzas 

■ 山 “F*«{| 

Captionedlmages 

Adapter.java 


Now that the adapter can receive the data, we’ll get the adapter to 
display it in the re cycler view by writing the onBindViewHolder () 
method. 
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Add the data to the card views 


The onBindViewHolder () method gets called whenever the 
recycler view needs to display data in a view holder. It takes two 
parameters: the view holder that data needs to be bound to, and 
the position in the data set of the data that needs to be bound. 


We need to populate our card view with data. The card view 
contains two views, an image view with an ID of inf o_image, 
and a text view with an ID of inf o_text. We’ll populate these 
with data from the captions and image Ids arrays. 

Here’s the code that will do that: 


□ 

BitsAndPizzas 

L L3 

app/sre/main 

LQ 


import android. widget. ImageView; - ^ c Vc usi 吒 ihtst t%bra dlasscs. 

import android.widget.TextView; ^ 
import android.graphics•drawable.Drawable; 



java 


com.hfad.bitsandpizzas 

o 

f“li4 …垂 

Captionedlmages 


Adapter.java 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter•ViewHolder>{ 


private String[] captions; 

private int[] imagelds; TilCSC vandblcs 

ta\>*bioir\S 

y-csouV"^c IPs of *bV»c 

Display 七 he image 
•m 七 he Imajcl/icw. 

ImageView imageView = (ImageView) cardView. findViewById(R. id. info_image); 
Drawable drawable = cardView.getResources().getDrawable(imagelds[position]); 
imageView. setlmageDrawable (drawable); 
imageView.setContentDescription(captions[position]); 

TextView textView = (TextView) cardView. f indViewByld (R. id. info_text); 
textView.setText(captions[position]); 

个 

Display daf*tioir> *m -the 


public void onBindViewHolder(ViewHolder holder, int position){ 

CardView cardView = holder.cardView; 


That’s all the code we need for our adapter. We’ll show you the 
full code on the next page. 
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The full code for CaptionedlmagesAdapter.java 

package com.hfad.bitsandpizzas; 


import android.support.v7.widget.RecyclerView; 
import android.view.Layoutlnflater; 
import android.view.ViewGroup; 
import android.support.v7.widget.CardView; 
import android.widget • 工 mageView; \ usm^. 

import android.widget.TextView; 
import android.graphics.drawable.Drawable; 



TV^csc arc i\\t classes wcVc 


private String[] captions; 
private int[] imagelds; 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter•ViewHolder>{ 

□ 

BitsAndPizzas 

M" ~ 1 

publlC StatiG GlaSS ViewHolder extends RecyclerView.ViewHolder{ app '^ iain 

private CardView cardView; I n - -j 

public ViewHolder(CardView v) { __I 

super (v) ; 

Wcwttoldc\r will display a Cav-dWcw. 


java 


cardView = v; 


L Q 


public CaptionedlmagesAdapter(String[] captions, int[] imagelds){ 
this.captions = captions; 个 

this•imagelds = imagelds; Pass da*ta *to i\\t adapter "m \U doy>s*t\rud*to\r- 


com.hfad.bitsandpizzas 

I Li... 

Ifj 

Captionedlmages 

Adapter.java 


QOverride 

public CaptionedlmagesAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType){ 
CardView cv = (CardView) Layoutlnflater•from(parent•getContext()) 

• inflate(R.layout•card—captioned—image, parent, false); 
return new ViewHolder(cv); 个 

} Use ouv- layout -Pov -the C^v-cH/icws. 

public void onBindViewHolder(ViewHolder holder, int position){ 

CardView cardView = holder.cardView; 

工 mageView imageView = (工 mageView)cardView.findViewByld(R.id.info 一 image); 

Drawable drawable = cardView.getResources()•getDrawable(imagelds[position]); 

imageView.setlmageDrawable(drawable); 

imageView.setContentDescription(captions[position]); 

TextView textView = (TextView)cardView.findViewByld(R.id.info_text); 
textView.setText(captions[position]); , 

} Populate Cav-dV'ic^s ImayV'iow 

a^d 7c%*t\/'ic>w W 七 data- 

QOverride 

public int getltemCount(){ 

return captions . length; ^ 一 - The number o( daia iiems. 
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create recycler view 


Create the rccyclcr view 

So far we’ve created a card view and an adapter. The next thing 
we need to do is create the re cycler view. The re cycler view will 
pass the adapter pizza data so that it can populate the card views 
with pizzas. 

We’re going to put the re cycler view in a new fragment. This is 
because we’re going to display it in Main Activity whenever 
the user clicks on the Pizzas option in the navigation drawer: 



13:37 


Bits And Pizzas 


13:38 


Pizzas 


Home 


Pizzas 


Pasta 


Stores 


Diavolo 


Funghi 


We’ll start by creating the fragment. Add a new blank 
fragment to your project. Give the fragment a name of 
“PizzaMaterialFragment” and a layout name of “fragment_pizza. 
material”. 


On the next page, we’ll add the re cycler view to the layout. 
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Add the RccycIcrViGW to the layout 


You add a re cycler view to the layout using the 
〈 android•support.v7.widget.RecyclerView> 
element. 


Here’s the code for fragment—pizza—material, xml] it contains a 
recycler view with an ID of pi z za_recycler: 


<?xml version="l.0" encoding= n utf-8"?> 

<android.support.v7.widget.RecyclerView 

xmlns : android:’▼ http://schemas.android.com/apk/res/android" 
android:id= n @+id/pizza_recycler" 个 

android: scrollbars= M vertical n ^^^ 一 ^ IS dc-fihcs a Rc^lcv-l/icw 

android:layout_width= M match_parent M 
android:layout_height= M match_parent n /> 


□ 

BitsAndPizzas 

L Q 

app/sre/main 


res 


with a vcvtuial sdv-ollbav-. 


□ 

layout 


UUL 


fragment_pizza_ 

material.xml 


You add scrollbars to the re cycler view using the 
android : scrollbars attribute. We’ve set this to 
"vertical " because we want our recycler view to display a 
vertical list that will scroll vertically. 

Now that we’ve added a recycler view to fragment—pizzajnaterial. 
xml, we need to add code to PizzaMaterialFragment.java to control 
its behavior. 


Using the adapter 

In the code for PizzaMaterialFragment.java, we’ll get the re cycler 
view to use the adapter. We need to tell the adapter what 
data to use via the adapter’s constructor, and then use the 
RecyclerView setAdapter () method to assign the adapter 
to the re cycler view: 


Recycler 

View 


Adapter 




Data 


We’ll show you the code for PizzaMaterialFragment.java on the next 
page. 
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PizzaMaterialFragment code 


The PizzaMatGrialFragmGwt.java code 

Here’s the code for PizzaMateriaIFragment.java (it creates an instance of 
CaptionedlmagesAdapter, tells it to use pizza names and images 
for its data, and assigns the adapter to the re cycler view): 

package com.hfad.bitsandpizzas; 


import android.app.Fragment; 
import android.os.Bundle; 

import android.support.v7.widget.RecyclerView; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup 


BitsAndPizzas 


L d 

app/sre/main 


CL ) 

WcVc us'm^ dlssscs. 


public class PizzaMaterialFragment extends Fragment { 

@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container, 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView)inflater.inflate( 


java 

com.hfad.bitsandpizzas 

t\»%* F*«{| 
f“li■ 

PizzaMaterial 
Fragment, java 


R.layout.fragment_pizza_material, container, false); 

Use the layout wc updated 

the pv-evious pa^e. 


pizzaNames [i] = Pizza.pizzas [i] .getName() ; . /\dd 


String[] pizzaNames = new String[Pizza.pizzas.length]; 
for (int i = 0; i < pizzaNames.length; i++) { 

d {x> av-vay 

} of dir>d f images 

-to avvay of 

int[] pizzalmages = new int[Pizza.pizzas.length]; 
for (int i = 0; i < pizzalmages.length; i++) { 

pizzalmages[i] = Pizza.pizzas[i].getImageResourceId(); 




Pass -the avv-ays -to -the adap-tev-. 


CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter (pizzaNames , pizzalmages); 
pizzaRecycler•setAdapter(adapter); 
return pizzaRecycler; 


There’s just one more thing we need to do: we need to specify ho' 
the views in the re cycler view should be arranged. 
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A RccyclerViGW uses a layout 
manager to arrange its views 

One of the ways in which a re cycler view is more flexible than a 
list view is when it comes to arranging its views. A list view displays 
its views in a single vertical list, but a recycler view gives you more 
options. You can choose to display views in a linear list, a grid, or a 
staggered grid. 

You specify how to arrange the views using a layout manager. The 
layout manager positions views inside a re cycler view, and the type 
of layout manager you use determines how items are positioned: 



UnearlayoutManager ^ridlayoutManagcr 

This arranges items in a This arranges items in a grid, 

vertical or horizontal list. 


On the next page, we’ll show you how to specify which layout 
manager to use. 


Staggered 备 rid 
LayoutManager 

This arranges 
unevenly sized items 
in a staggered grid. 
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layout managers 


Specifying the layout manager 


You specify the layout manager, using the following lines of code: 


LinearLayoutManager layoutManager = new LinearLayoutManager(getActivity()); 


pizzaRecycler.setLayoutManager(layoutManager); 

The above code tells the re cycler view to use a 
LinearLayoutManager, so all the views in the re cycler view 
will be displayed in a list: 


TWis weds -to be a l-t you 

tWis codt m attwity, you use 

i^\s mstcad 



W\)Cy\ you use a 
^ L*mca\rLayouiMa^agcv- 
iiems a\rc displayed’m a 
Imc3v* list 


Using a layout manager means that it’s easy to change the 
appearance of your recycler view. If you want to display your views 
in a grid instead, for instance, you just change the code to use a 
GridLayoutManager instead: 


GridLayoutManager layoutManager = new GridLayoutManager(getActivity(), 2); 


pizzaRecycler.setLayoutManager(layoutManager); 



13:39 


=Pizzas 



TVis says 

should be *bwo dolumr\s 



Diavolo Funghi 


y/idc- 

l/Vhcr> you i-t b> a 

^\ridLayou'tA1a^ajc\r i i-tcr»»s 
displayed m a yr\d- 
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The full PizzaMatGrialFragmGwt.java code 

Here’s the full code for PizzoMaterialFragment.java\ 


package com.hfad.bitsandpizzas; 


import android.app.Fragment; 
import android.os.Bundle; 

import android.support.v7.widget.LinearLayoutManager; 

import android.support.v7.widget.RecyclerView; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup; 

public class PizzaMaterialFragment extends Fragment { 


WcVc dldsS) so y/c 

Y\ttd *to iw'fovb »*t- 


□ 


BitsAndPizzas 



app/sre/main 



java 



QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView)inflater.inflate( 

R.layout.fragment pizza material, container, false); 


com.hfad.bitsandpizzas 

LQ 

|r) 

PizzaMaterial 

Fragment.java 




String[] pizzaNames = new String[Pizza.pizzas.length]; 
for (int i = 0; i < pizzaNames.length; i++) { 

pizzaNames[i] = Pizza.pizzas[i]•getName(); 



All 七 his todt s-tays -the sa me. 


int[] pizzalmages = new int[Pizza.pizzas.length]; 
for (int i = 0; i < pizzalmages•length; i++) { 

pizzalmages[i] = Pizza.pizzas[i]•getlmageResourceld(); 


CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter(pizzaNames, pizzalmages) 
pizzaRecycler.setAdapter(adapter); 

LinearLayoutManager layoutManager = new LinearLayoutManager(getActivity()); 
pizzaRecycler. setLayoutManager (layoutManager) ; 

.WlcVc jomj *to display 
七 he C3v-d\/icv/s *m a Imeav 
list so wcVc usmj d 


return pizzaRecycler; 



Now that we’ve finished the re cycler view code, let’s change 
Main Activity so that it’s displayed when the user clicks on the 
Pizzas option in the navigation drawer. 
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use PizzaMaterialFragment 


fret MaiwActivity to use the new PizzaMaterialFragmcwt 

When the user clicks on the Pizzas option, the List Fragment 
called PizzaFragment currently gets displayed. To display 
PizzaMaterialFragment instead, we need to replace all 
references to PizzaFragment in our MainActivity code 
with PizzaMaterialFragment. 

PizzaFragment is used two times in MainActivity.java, in its 
onCreate () and selectltem () methods. Change these 
lines of code to use PizzaMaterialFragment instead: 


package com.hfad.bitsandpizzas; 


r*v 



public class MainActivity extends Activity { 

• 參 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 

• 參* 

getFragmentManager().addOnBackStackChangedListener( 
new FragmentManager.OnBackStackChangedListener() 
public void onBackStackChanged() { 


BitsAndPizzas 


L Q 

app/sre/main 


java 


□ 


com.hfad.bitsandpizzas 

Id 

MainActivity.java 


if (fragment instanceof PizzaMaterialFragment) 

currentPosition = 1; 


private void selectltem(int position) 




mstcad ok TV^is ti^at 

诎⑼ ^ u 狀 tkks 咖如 P ； .z^s ^ 

ndv'i^di'io^ dv-av/cv-, ouv- siimy 
list y/ill be displayed. 


fragment = new PizzaMaterialFragment(); 

break; 


Before we run the app, let’s go through what the code we’ve 
written so far will do. 
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What happens when the code ruws 



The user clicks on the Pizzas option in the navigation drawer. 

Code in MainActivity runs to display Piz zaMaterialFragment, and 
PizzaMaterialFragment^ onCreateView () method runs. 



MainActivity 



onCreateView() 


PizzaMaterial Fragment 



The PizzaMaterialFragment onCreateView() method creates a 
LinearLayoutManager and assigns it to the recycler view. 

The LinearLayoutManager means that the views will be displayed in a list. As 
the re cycler view has a vertical scrollbar, the list will be displayed vertically. 



PizzaMaterialFragment 


LinearLayoutManager 



The PizzaMaterialFragment onCreateView() method creates a new 
Captionedlmages Adapter. 

It passes the names and images of the pizzas to the adapter using the adapter’s 
constructor, and sets the adapter to the recycler view. 



PizzaMaterialFragment Captionedlmages Adapter 
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what happens 


The story continues 


O The adapter creates a view holder for each of the CardViews the 
recycler view needs to display. 




CaptionedlmagesAdapter 



ViewHolder 


/^\ 

u 

Card View 

CardView 


o 


The adapter then binds the pizza names and images to the text view 
and image view in each card view. 


Diavolo data 



Diavolo data 



TextView 



Card View 


Funghi data 


CaptionedlmagesAdapter 



Funghi data 


ViewHolder 


“Funghi:_^ 

I 1 T 

R. dravmbj^Funghi 


ImageView 


Kdrawable.Funghi 


Card View 


o 

TextView 

o 

ImageView 


Next, let’s run the app and see how it looks. 
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Test drive the app 

Run the app, open the navigation drawer, and click on the 
Pizzas option. 



13:37 


Bits And Pizzas 


Home 


Pizzas 


13:38 


Pizzas 


Pasta 


Diavolo 


Funghi 


Stores 


you c\\tV ov\ 

七 he pizzas 

•is displayed. \i toyrbams 
a I'mcav- l'is*t o-f tav-d 
viev/s fofula-tcd 


The re cycler view is displayed containing a linear list of 
card views. Each card view contains pizza data. 
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magnets 


RecyclerView Magnets 

Use the magnets on this page and the next to create a new recycler view 
for the pasta dishes. The recycler view should contain a linear list of card 
views, each one displaying the name and image of a pasta dish. 

I^TKis is todt -fov Pas*ta dbss. 

package com.hfad.bitsandpizzas; 

public class Pasta { 

private String name; 
private int imageResourceld; 

public static final.[ ] pastas = { 

new Pasta("Spaghetti Bolognese ", R.drawable.spag_bol) 
new Pasta (’'Lasagne ， ' ， R. drawable . lasagne) 



□ 

BitsAndPizzas 

L Q 

app/src/main 

L a 


java 


com.hfad.bitsandpizzas 

Q 

Pasta.java 


private Pasta(String name, int imageResourceld) 
this.name = name; 

this•imageResourceld = imageResourceld; 


getName() 


「Pasta * 


public String _ 
return name; 


public int . 

return imageResourceld, 



RecyclerView 


android.support•v7•widget.RecyclerView 


"vertical" 


Q 

I getlmageResourceld() 


This is the toAt -Pov- the layout 




xmlns : android= M http : // schemas . android. com/apk/res/android" 
android : id= M @ + id/pasta_recycler" 


android : layout_width= M match_parent" 
android : layout—height 二 '’match—parent" /> 


□ 

BitsAndPizzas 

413 

app/src/main 


res 




layout 



fragment_pasta 


material.xml 
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TV^is *»s i\\t codt (or PastaMaWialFVa， ⑼ tjava 


public class PastaMaterialFragment extends Fragment 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container 

Bundle savedlnstanceState) { 

RecyclerView pastaRecycler = (RecyclerView)inflater.inflate( 


□ 

BitsAndPizzas 

L Q 

app/src/main 


java 



com.hfad.bitsandpizzas 

I U\*u F*«{| 

Id 

Pasta 

， container, false) ; Material 

Fragment.java 


String[] pastaNames = new String[Pasta.pastas.length]; 
for (int i = 0; i < pastaNames.length; i++) { 

pastaNames[i] = Pasta.pastas[i].getName(); 


int[] pastalmages = new int[Pasta.pastas.length]; 
for (int i = 0; i < pastalmages•length; i++) { 

pastalmages[i] = Pasta.pastas[i].getImageResourceId(); 


adapter 


new 


(pastaNames, 


pastaRecycler.setAdapter(adapter) 


layoutManager = new (getActivity()); 

pastaRecycler.setLayoutManager(layoutManager); 
return pastaRecycler; 
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magnets solution 



RecyclerView Magnets Solution 

Use the magnets on this page and the next to create a new recycler view 
for the pasta dishes. The recycler view should contain a linear list of card 
views, each one displaying the name and image of a pasta dish. 


package com.hfad.bitsandpizzas; 

public class Pasta { 

private String name; 

private int imageResourceld; IVs 3r\ avvay objct*U- 

public static final f ^ as ^a ~| .[] pastas = { 

new Pasta("Spaghetti Bolognese ", R.drawable.spag_bol) 
new Pasta("Lasagne", R.drawable.lasagne) 


□ 

BitsAndPizzas 

L Q 

app/src/main 

L a 

java 


private Pasta(String name, int imageResourceld) 
this.name = name; 

this•imageResourceld = imageResourceld; 


public String 


getName() 


return name; 


"These methods av-c used by 


public int 



com.hfad.bitsandpizzas 

13 

Pasta.java 



TKis is a spav-c 


return imageResourceld; 


< 


/\dd i\\t v-c^lcv- view -to layout 


android.support•v7•widget•RecyclerView 


xmlns : android="http :// schemas.android.com/apk/res/android' 
android : id="@+id/pasta recycler" 


android: scrollbarsjf = I ” vertical” Md s^ollba,s. 

^ • ••••••••••••••••••••••••••••••••• • • • • 


□ 

BitsAndPizzas 

413 

app/src/main 


res 


android : layout_width= M match_parent" 
android:layout height="match parent" / > 


□ 

layout 


</ 


fragment_pasta_ 

material.xml 
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public class PastaMaterialFragment extends Fragment { 

@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container 

Bundle savedlnstanceState) { 

RecyclerView pastaRecycler = (RecyclerView)inflater.inflate( 



java 


Use tW,s layout ^ 


,container, false); 


String[] pastaNames = new String[Pasta.pastas.length]; 
for (int i = 0; i < pastaNames.length; i++) { 

pastaNames[i] = Pasta.pastas[i].getName(); 


m 3 

com.hfad.bitsandpizzas 

I \t\iu F*«{| 

Id 

Pasta 
Material 
Fragment.java 


int[] pastalmages = new int[Pasta.pastas.length]; 
for (int i = 0; i < pastalmages•length; i++) { 

pastalmages[i] = Pasta.pastas[i]•getlmageResourceld(); 

} I^VcVc usmg the 


CaptionedlraagesAdapterl adapter 


Cap-tiohcdUagcsAdaptcv- 

we y/irotc cav-licv-. 

/ 


new 


Cap tionedlmagesAdapter 

pastaRecycler.setAdapter(adapter); 


Pass pas*ta ay>d 
images h> 七 he ad3p*tcv-. 


(pastaNames, 



)； 


new 


LinearLayoutManage - ( layoutManager 

pastaRecycler.setLayoutManager(layoutManager); 
return pastaRecycler; ^ 

Use Lmca^rLayoutMa^aj^ -to 
display views m a I'mcav- list 



(getActivity()); 



u did〆 七 Y\ttd bo use 
一 iiicsc ma^cts. 


ArrayAdapter 
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where we are 


Where we've got to 


Here’s a reminder of where we’ve got to with our app: 


o 

o 

o 


When the app gets launched, it starts MainActivity. 

The activity uses layout activity—main.xml and has a navigation drawer. When the user clicks on 
one of the options in the navigation drawer it displays the appropriate fragment. 

When the user clicks the Pizzas option, it displays PizzasMaterialFragment. 

Piz zasMaterialFragment contains a recycler view. 

PizzaMaterialFragment uses an adapter, CaptionedlmagesAdapter, to display 
card views showing an image and caption for each pizza. 

The card views are defined in card—captioned—image, xml. 



Device 


activity—main.xml 


MainActivity.java 




Top 
Fragment.java 


： Layout>| 
: /Layou-tl 


fragment 

top.xml 



Pasta 

Fragment.java 


: Layout! 

: /Layou-tl 




Stores 


OrderActivity.java 


jus*t Cxcdi^td 3li 

/ kLayou^l 

— i/L-ayowtl 

card 



activity—order.xml 



PizzaDetail 

Activity.java 


activity—pizza_ 
detail.xml 


Captionedlmages 
\J Adapter.java 


PizzaMaterial 
Fragment.java 

Pizzas.java 

Wcy/c v\oi dircaicd 七 his yet 
I/Vcll do -this 时此 and yt 

Pizia/V]a-tcv-ialFv*agmc^t b> 
s*ta\rt it 


captioned. 

image.xml 



The next thing we need to do is get the re cycler view to respond to 
clicks so it starts Piz zaDe tail Activity when the user clicks 
on one of the pizzas. Piz zaDe tail Activity will then display 
details of the pizza the user selected. 

We’ll create Piz zaDe tail Activity next. 
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Create PizzaPctailActivity 

Piz zaDe tail Activity will display the name of the pizza the 
user selected, along with its image. 

Create a new blank activity called “PizzaDetailActivity” with a 
layout name of “activity—pizza—detail” and a title of “Pizza Detail”. 
Then update activity—pizza—detail, xml with the code below, which 
adds a text view and image view to the layout that we’ll use to 
display details of the pizza: 


一 I 
— 


<LinearLayout xmlns : android:，▼ http://schemas.android.com/apk/res/android" 
xmlns : tools= n http : //schemas.android.com/tools M 

android: layout 一 width: ”match_^parent ▼’ BitsAndPizzas 

android: layout_height= M match_^parent" L 「j 

android: orientation:” vertical n app/sre/main 

tools : context= n com. hf ad. bitsandpizzas . Pi zzaDe tail Activity ’） 




<TextView 

android:id= n @+id/pizza_text" 
android:layout width= n wrap content' 


P*iziaPc*tailA^W*i*tY toy\*ta*ms re |^n—| 




ayout 


Qj 


android: layout_height= n wrap—content” 
android:textAppearance= n ?android:attr/textAppearanceLarge" /> 


activity_pizza_ 
detail.xml 


<ImageView 

android:id= n @+id/pizza—image” 
android:layout_height= n wrap 一 content" 
android:1ayout_width= n match_parent n 
android:adj us tViewBounds= n true"/> 




</LinearLayout> 


We’ll look at what we need the code for PizzaDetailActivity.java to 
do on the next page. 
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requirements 


What PizzaPctailActivityjava needs to do 

There are a few things that we need PizzaDetailActivity.java to 
do: 


o 

o 


Pi zzaDe tail Activity^ main purpose is to display the name 
and image of the pizza the user has selected. To do this, we’ll get 
the ID of the pizza the user has selected from the intent that started 
the activity. We’ll pass this to Pi zzaDe tail Activity from 
Piz zaMaterialFragment when the user clicks on one of the 
pizzas in the recycler view. 

Back in Chapter 9, we created a menu resource file that 
describes items we wanted to add to the action bar. We’ll 
use the onCreateOptionsMenu () to add these items to 
Piz zaDe tail Activity^ action bar. 


o 

o 

o 


The menu resource file describes a Share action that we can use to 
share information. We’ll add an intent to the Share action that will 
share the name of the pizza the user has selected. 

The menu resource file also describes a Create Order action. When 
the user clicks on this, we’ll start Order Activity. 

We’ll enable the PizzaDetailActivity’s Up button so that 
when the user clicks on it, they get returned to MainActivity. 


Update AndroidMaHifest.xml 

We’ll start by updating AndroidManifest.xml to specify that 
MainActivity is the parent of PizzaDetailActivity. 

This means that when the user clicks on the Up button in 
Piz zaDetailActivity^ action bar, MainActivity will 
be displayed: 

〈activity 

android:name=".Piz zaDetailActivity" 

android:label= M @string/title—activity—pizza—detail n 

android : parentActivityName=" . MainActivity" > 

</activit y > is s 


□ 


BitsAndPizzas 


L o 


app/src/main 

</^ll 

AndroidManifest.xml 


Once you’ve done that, we’ll look at how to get the re cycler 
view to respond to clicks. 
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The code for PizzaPetailActivity.java 

Here’s the full code for PizzaDetailActivity.java (don’t worry if it seems 
like a lot, this is all code that you’ve seen before): 


package com.hfad.bitsandpizzas; 

import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.Menu; 
import android.view.Menultern; 
import android.widget.ImageView; 
import android.widget.ShareActionProvider; 
import android.widget.TextView; 


■ 

BitsAndPizzas 



WcVc classes. 


app/sre/main 

L a 

java 



com.hfad.bitsandpizzas 

I fokli ‘…儀 

\o 

PizzaDetailActivity.java 


public class PizzaDetailActivity extends Activity { 


private ShareActionProvider ShareActionProvider; 

public static final String EXTRA 一 PIZZANO = "pizzaNo" ; f "to pass 

一 tKc ID o\ the pi^za as cxtva 

ih-fo\rrr»a-tioh ih the ihtcht. 

@Override 

protected void onCreate(Bundle savedlnstanceState) { 
super.onCreate(savedlnstanceState); 
setContentView(R.layout.activity_j>izza_detail); 


//Enable the Up button 

getActionBar () . setDisplayHomeAsUpEnabled (true) ; Enable Up louttoir\. 


TextView textView = (TextView) findViewByld (R. id.pizza_text) 
textView. setText (pizzaName); 


//Display details of the pizza 

int pizzaNo = (Integer)getlntent().getExtras().get(EXTRA_PIZZANO); 

String pizzaName = Pizza.pizzas[pizzaNo]•getName(); 

^ the 

the usc\r dkose 
the ihtch-t. 

int pizzalmage = Pizza.pizzas[pizzaNo].getlmageResourceld(); 

ImageView imageView = (ImageView) findViewByld(R. id.pizza—image); 
imageView.setlmageDrawable(getResources().getDrawable(pizzalmage)); 
imageView.setContentDescription(pizzaName); 

Use IP bo populate 
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PizzaDetailActivity code 


The PizzaPetailActivity code (continued) 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 

getMenuInflater().inflate(R.menu.menu main, menu) 


/\ad i-tcms *m ⑼ u 

-f lic -to bav-. 


//Share the name of the pizza 

TextView textView = (TextView)findViewByld(R.id.pizza_text); 
CharSequence pizzaName = textView.getText(); 

MenuItem menultem = menu.findItem(R.id.action 一 share); 

shareActionProvider = (ShareActionProvider) menultem.getActionProvider() 
Intent intent = new Intent(Intent.ACTION 一 SEND); 
intent.setType("text/plain"); 

intent.putExtra(Intent.EXTRA TEXT, pizzaName); 


shareActionProvider.setSharelntent(intent); 



BitsAndPizzas 



return true 


app/sre/main 


Set the default text -to 

shave m the Shav-c 



@Override 

public boolean onOptionsItemSelected(Menultem item) { 
switch (item.getltemldO) { 

case R.id.action_create_order : 

Intent intent = new Intent(this, OrderActivity.class); 
startActivity(intent); 
return true; 
default : 

return super.onOptionsItemSelected(item); 


java 


com.hfad.bitsandpizzas 



PizzaDetail 

Activity.java 




Start 

u scv c\\cVs ov\ *>*b m *bKc aciicw bav- 


Once you’ve updated your PizzaDetailActivity.java code, we’ll 
look at how to get the re cycler view to respond to clicks. 
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ftettmg a RccyclerViGW to respond to clicks 

We need to get items in the recycler view to respond to clicks so 
that we can start Pi zzaDe tail Activity when the user clicks 
on a particular pizza. 

When you create a navigation list with a list view, you can 
respond to click events within the list by giving the list view an 
Onl temClickListener. The list view listens to each of the 
views that it contains, and if any of them are clicked, the list view 
calls its Onl temClickListener. That means that you can 
respond to list item clicks with very little code. 


List views are able to do this because they inherit a bunch of 
functionality from a very deep hierarchy of superclasses. Re cycler 
views, however, don’t have such a rich set of built-in methods, as 
they don’t inherit from the same superclasses: 



While this gives you more flexibility, it also means that with the 
recycler view you have to do a lot more of the work yourself. So 
how do we get the re cycler view to respond to clicks? 
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listen to views 


You can listen to views from the adapter 

If you want your recycler view to respond to clicks, you need to write the 
code yourself. In order to write event code, you need access to the views 
that appear inside the re cycler view. So where do you do that? 

The views are all created inside the CaptionedlmagesAdapter 
class. When a view appears on screen, the re cycler view calls the 
onBindViewHolder () code to make the card view match the details 
of the list item. 

Let’s say you want to send the user to an activity that displays a single 
pizza whenever a pizza card view is clicked. That means you could put 
some code inside the adapter to start an activity like this: 

class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter•ViewHolder>{ 


public void onBindViewHolder(ViewHolder holder, int position){ 

CardView cardView = holder.cardView; 

工 mageView imageView = (工 mageView)cardView.findViewByld(R.id.info_image); 

Drawable drawable = cardView.getResources()•getDrawable(imagelds[position]); 
imageView.setlmageDrawable(drawable); 

TextView textView = (TextView)cardView.findViewByld(R.id.info_text); 
textView.setText(captions[position]); 

cardView.setOnClickListener(new View.OnClickListener(){ 

©Override 

public void onClick (View v) { 

Intent intent = new Intent(container.getContext(), PizzaDetailActivity.class); 
intent.putExtra(PizzaDetailActivity.EXTRA_PIZZANO, position); 
container.getContext()•startActivity(intent); 

codt -to Captio^cdlmajcsAdaf-tcv- 

will start PiziaPctailA^W'rty a 

Cav*d\Ao/ is disked- 



But just because you could write this code, doesn’t necessarily mean 
that you should. 





You could respond to a click event by adding code to your adapter class. Is 
there a reason why you wouldn’t want to do that? 
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Keep your adapters reusable 

If you deal with click events in the CaptionedlmagesAdapter 
class,jo^7 / limit how that adapter can be used. Think about the app we’re 
building. We want to display lists of pizzas, pasta, and stores. In each 
case, we’ll probably want to display a list of captioned images. If we 
modify the CaptionedlmagesAdapter class so that clicks always 
send the user to an activity that displays details of a single pizza, we 
won’t be able to use the CaptionedlmagesAdapter for the pasta 
and stores lists. We’ll have to create a separate adapter for each one. 

Pecouple your adapter with an interface 

Instead, we’ll keep the code that starts the activity outside of the 
adapter. When someone clicks on an item in the list, we want the 
adapter to call the fragment that contains the list and the fragment 
code can then fire off an intent to the next activity. That way we 
can reuse CaptionedlmagesAdapter for the pizzas, pasta, and 
stores lists, and leave it to the fragments in each case to decide what 
happens in response to a click. 

We’re going to use a similar pattern to the one that allowed us to 
decouple a fragment from an activity. We’ll create a Listener 
interface inside Cap tionedlmages Adapter like this: 

public static interface Listener { 

public void onClick(int position); 


We’ll call the Listener’s onClick () method whenever one of the 
card views in the recycler view is clicked. We’ll then add code to 
PizzaMaterialFragment so that it implements the interface; 
this will allow the fragment to respond to clicks and start an activity. 


This is what will happen at runtime: 


o 

❺ 


A user will click on a card view in the recycler view. 
The Listener’s onClick () method will be called. 



The onClick () method is implemented in Piz zaMaterialFragment. 
Code in the fragment starts PizzaDetailActivity. 


Let’s start by adding code to CaptionedlmagesAdapter.jam. 
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Add the interface to the adapter 

We’ve updated our CaptionedlmagesAdapter.java code to add the Listener 
interface and call its onClick () method whenever one of the card views is 
clicked (apply the changes to your code, then save your work): 


package com.hfad.bitsandpizzas; 


import 

import 

import 

import 

import 

import 

import 

import 


android.graphics.drawable.Drawable; 
android.support.v7.widget.RecyclerView; 
android.view.Layoutlnflater; 

android. view. View; ^ - uSm ^ 七 Wis c%*tv-a dlass, so imforb it 

android.view.ViewGroup; 
android.support.v7.widget.CardView; 
android.widget. 工 mageView; 
android.widget.TextView; 


□ 

BitsAndPizzas 

L L 3 

app/sre/main 

L a 


java 



com.hfad.bitsandpizzas 

<l 4 M 

fkWIii--! 

Captionedlmages 

Adapter.java 


class CaptionedlmagesAdapter extends RecyclerView.Adapter<CaptionedImagesAdapter.ViewHolder>{ 


private String[] captions; 
private int[] imagelds; 

private Listener listener; ^^ Add "the Lis-tcK>cv- ds d pv-iva-tc variable- 


public static interface Listener { 

public void onClick(int position); 


TWis is 


public static class ViewHolder extends RecyclerView.ViewHolder{ 
private CardView cardView; 
public ViewHolder(CardView v) { 
super(v); 
cardView = v; 

^ v\oi ihese mcihods. 

public CaptionedlmagesAdapter(String[] captions, int [ ] imagelds) { 
this.captions = captions; 
this.imagelds = imagelds; 
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The CaptionedlmagesAdapter.java code (contmued) 

public void setListener(Listener listener){ 

this.listener = listener; ^. /idtiv'i-tys ar\d Vill use tWis 

} mc*t^od *to v-ejis-tev- as d listener. 

@Override 

public CaptionedlmagesAdapter•ViewHolder onCreateViewHolder(ViewGroup parent, int viewType){ 
CardView cv = (CardView) Layoutlnflater•from(parent•getContext()) 

• inflate(R.layout•card—captioned—image, parent, false); 
return new ViewHolder(cv); 


public void onBindViewHolder(ViewHolder holder, final int position){ 
CardView cardView = holder.cardView; 


工 mageView imageView = ( 工 mageView)cardView.findViewByld(R.id.info—image); 
Drawable drawable = cardView.getResources()•getDrawable(imagelds[position]); 
imageView.setlmageDrawable(drawable); 
imageView.setContentDescription(captions[position]); 

TextView textView = (TextView)cardView.findViewByld(R.id.info_text); 
textView.setText(captions[position]); 

cardView.setOnClickListener(new View.OnClickListener() { 


@Override 

public void onClick (View v) { 
if (listener != null) { 

listener.onClick(position); 

} 个 

} the Ca\rd\/icy/ is ca\\ 

} ) ; ^ Lisic^ir OhClidO method. 

} 

QOverride 

public int getltemCount(){ 
return captions.length; 


□ 


BitsAndPizzas 


H^jj 

app/sre/main 


java 


com.hfad.bitsandpizzas 

■ t\tu 

f“li■ 

LJ 

Captionedlmages 

Adapter.java 


Now that we’ve added a Listener to the adapter, we’ll 
implement it in PizzaMaterialFragment.java. 
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PizzaMaterialFragment code 


Implement the listener in 
PizzaMaterialFragmcwt-java 

We’ll implement CaptionedlmagesAdapter’s Listener 
interface in PizzaMaterialFragment so that when a card 
view in the recycler view is clicked, Pi zzaDe tail Activity 
will be started. Here’s the code: 


package com.hfad.bitsandpizzas; 


import android.app.Fragment; 

import android.content.Intent; 

import android.os.Bundle; 

import android.support.v7.widget.LinearLayoutManager; 
import android.support.v7.widget.RecyclerView; 
import android.view.Layoutlnflater; 
import android.view.View; 
import android.view.ViewGroup; 

public class PizzaMaterialFragment extends Fragment i 


WicVe |r\*tcir\*b *to s*t3V " 七 

adtivi-tv, so imfov-t dass. 

□ 

BitsAndPizzas 

413 


app/sre/main 

L Q 

java 

LQ 

com.hfad.bitsandpizzas 

f“l'■ 

o 

PizzaMaterial 

, Frag merit, java 

@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

RecyclerView pizzaRecycler = (RecyclerView)inflater.inflate( 

R.layout.fragment pizza material, container, false); 


String[] pizzaNames = new String[Pizza.pizzas.length]; 
for (int i = 0; i < pizzaNames.length; i++) { 

pizzaNames [i] = Pizza.pizzas [i] . getName () ; ^This Code stays same 



int[] pizzalmages = new int[Pizza.pizzas.length]; 
for (int i = 0; i < pizzalmages•length; i++) { 

pizzalmages[i] = Pizza.pizzas[i].getImageResourceId(); 
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The PizzaMatGrialFragmGwt.java code (contmued) 

CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter(pizzaNames, pizzalmages); 
pizzaRecycler.setAdapter(adapter); 

LinearLayoutManager layoutManager = new LinearLayoutManager(getActivity()); 
pizzaRecycler.setLayoutManager(layoutManager); 


adapter.setListener(new CaptionedlmagesAdapter.Listener() { 
public void onClick(int position) { 

Intent intent = new Intent(getActivity(), PizzaDetailActivity.class); 
intent.putExtra(PizzaDetailActivity.EXTRA—PIZZANO, position); 
getActivity().startActivity(intent); 


})； 

return pizzaRecycler; 


TWis Listc^cv- 

cmCUO method. I 七 s-tav-b 

fassmj \i 

|p i\^t fiz^a tVic usev (Most. 


That’s all the code we need to make views in the recycler view 
respond to clicks. By taking this approach, we can use the same 
adapter and card view for different types of data that is composed 
of an image view and text view. 


□ 

BitsAndPizzas 

L Q 

app/sre/main 


java 



com.hfad.bitsandpizzas 

PizzaMaterial 
Frag merit, java 



PizzaMaterialFragment.java 


All -b^ese 

use same 
adaftev- air\d 
View. 


/ 




PastaMaterial Fragment, java 




Captionedlmages 

Adapter.java 


StoresMaterialFragment.java 


card_captioned 

image.xml 


Let’s see what happens when we run the code. 
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test drive 

Test drive the app 

Run the app, open the navigation drawer, and click on 
the Pizzas option. A list of card views is displayed, each 
one showing a different pizza, as before. Let’s see what 
happens when you click on one of the pizzas: 



^ A 


13:37 


13:38 


14:10 


W\\CY\ you dlidk ov\ 
a piz^a, its details 
a\rc displayed m 
PiziaPctailA^iiviiy. 

\C 


Stores 


you dl'itk oy \ 

七 Pizzas 外七 ’ 叫 〆^ 
piz*z<aMa 七 
is disflaycdi. 




Funghi 


There’s just one more thing we need to look at: the content 
we need to include in Top Fragment. 


Bits And Pizzas 


Home 


Pizzas 


Pasta 


Pizzas 


<-Pizza Detail 


Diavolo 


Diavolo 


The card view responds to the click, and displays 
PizzaDetailActivity. 
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Prmg the cowtcwt forward 


When we first looked at the design of the Pizza app, Top Fragment 
contained a list of navigation options. We moved these away 
from Top Fragment using a combination of an action bar and 
navigation drawer, leaving Top Fragment empty. So what should 
Top Fragment contain? 


Top Fragment is our top-level screen, so it’s the first screen that 
your users see when they start the app. Your top-level screen should 
be rewarding for both new and regular users, and one way you can 
do this is by bringing the content forward. 


If you look at some of the Google apps on your device, there’s 
one thing they have in common: they allow you to get to the main 
content of the app quickly by bringing some of it forward onto the 
top-level screen. The Calendar app displays upcoming events. Apps 
such as Play Books and Play Music display your recent actions and 
recommendations. They form the centerpiece of the top-level screen. 


TV>C Play Books 
app displays book 
you vc vcdcir>*tly 
dov/r>loddcd ； 

V*CdommCir>d3"tlOir>S 

-fov o*thcv* books 
you may cyjjoy. 


s 



SEE ALL 


The Calendav" 
app displays 

so ihcyVc easy 
■feo yt "to- 


We can bring the content forward in our Pizza app by displaying 
some of the food that’s available in Top Fragment. The good news 
is that you can do this with very little effort using the skills you’ve 
already learned in this chapter. 
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exercise 




You’re going to change TopFragment so that it displays introductory text and a recycler view 
that displays pizzas. First, write the layout code for fragment—top.xml. You need TopFragment 
to look like the image below. 


TVis is y/V^at you 

*to look like* 
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cf^l^rpen your pencil 


Next, add code to the box below to finish writing the code for 
TopFragment.java so that the recycler view is populated with two 
pizzas in a grid layout. If the user clicks on one of the pizzas, 
display its details in PizzaDetailActivity.java. 


public class TopFragment extends Fragment { 


QOverride 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

RelativeLayout layout = (RelativeLayout) 

inflater.inflate(R.layout.fragment top, container, false) 


you\r 

CoAc 

here. 


CaptionedlmagesAdapter adapter = 

new CaptionedlmagesAdapter(pizzaNames, pizzalmages) 
piz zaRecycler.setAdapter(adapter); 

adapter.setListener(new CaptionedlmagesAdapter•Listener() { 

public void onClick(int position) { 

Intent intent = new 工 ntent(getActivity(), PizzaDetailActivity.class) 
intent.putExtra(PizzaDetailActivity.EXTRA—PIZZANO, position); 
getActivity().startActivity(intent); 


})； 

return layout; 


Most o-P tk Code is the same as 4^- 

Pi2^Ma-tc\rialF\ra9rhCh-t.java. 
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exercise solution 


You’re going to change TopFragment so that it displays introductory text and a recycler view 
IfirL _ that displays pizzas, nrst, write the layout code for fragment—top. xml qu need TopFragment 

to look like the image below. 

§OL!M*VOH 

Do/ 七 v/ov-v^y i-P youv- dode looks 出以伙⑶七 *to ou\rs. a 代 

mav>y v/ays <^c ^ sWilav* lookup layout- 

<Rela*tivcLayou*t %^lhs ： ahd\roid= lW h*t*tp ： / / sdKe^as.ahdroid.dom/apk/ res/ 扣 droid” 

XmlhS:*tools 二 "Ivbtp://sdhcmas.ahdv-oid^om/*bools W 

ahdroid^layou^wid-th^ 
ar\dbroid:laYou*t_hei# 七二 
ahdroid ： padd*mg7op=- ,, l idp” 
ahdv , oid ： padd*m^Bo*t*boi^= = - ,, l ^>dip ;, 
ahdroid ： padd*m3Riglvt— , l 厶 dp” 

如 droidhpaddmgLrf t 二 ”1 厶 dp” 

*bools:dorrtwt 二 ' Ma.m/U 七 i … 切〜 

^^TWis is (or *tV)C 
<Tt%iV\t^ ^ mVodu^y M 

a^dvoi d: la you*t_wi <1 七 1^ 二 " 眯 3 七 ^1\_]^ 代灼七 ” 

andvoi d: la you 七一 1^ 吵七二 ” wrap 一 doh 七⑶七 ” 
ahdvoid:id 二 ” 沴 +id/wekome /> 


<ar\dv , oidsuppo\rtv 7 >wid 5 C*tRcdydlc\r\/icw 
andhroi d: i (1 二 ” 沴 +i d/pi zjz3^ytC^/c\cr )， 
ahdv-oid ： sdv-ollbav-s— w vc\rtidal W 



This is -Po\r -the 
V"Cdy^lc\r view. 


a^dvoi d: la you*t_wi 

andvoi d: la you 七一 hei—'tJWap 一 doh 七⑶七 ” 
a^dvoid^ayou-t^bclow^^+id/y/eldonr\c - _tc%*t ，； 

ahdvoid ： layou*t_mar5'm7op=- ,, l OdpV> 

</Rela*tivcLayou*t> 
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f^^rpen your pencil 


Next, add code to the box below to finish writing the code for 
TopFragment.java so that the recycler view is populated with two 
pizzas in a grid layout. If the user clicks on one of the pizzas, 
display its details in PizzdDetailActivity.java. 


public class TopFragment extends Fragment { 

@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 

RelativeLayout layout = (RelativeLayout) 

inflater.inflate(R.layout.fragment top, container, false) 


>uv" dodc 

S look 


RedydevView piziaRcdydlcv — (Rc^ydlcr\/icw)layou*t-f*mdi\/ic>wByldifR idi pi 
y\zjz3hl^n\es =■ hCw S-tvm^CZ ]； 

-for (*m*t i ― Oj i < 2 -j ••++){ 

y\zjz3hlsmncs[\] =■ Pizia.pizi3sCi3.^c*tN3i^cO ； 


jredydler)j 


piz^aImages =■ ^^ - Well display *bwo fiz^as. 

for (m*t i 二 0; i < Z; i++) { 

pizia|magcsCi3 =■ Pizia.piziasCiJ.^ctl^^^cRcsourdcldO; 

} Display the pizzas m a 七 yr\d- 

^v-idLayou-tMa^a^cr layou-tAls^a^cv ― ^v-idLayou-tMa^ayv-fytA^'tivi-tyO^Z); 
piziaRedydler.srtLayou-tMahagerOayou-tMahagcr); 


CaptionedlmagesAdapter adapter = 

new CaptionedlmagesAdapter(pizzaNames, pizzalmages) 
piz zaRecycler.setAdapter(adapter); 

adapter.setListener(new CaptionedlmagesAdapter•Listener() { 

public void onClick(int position) { 

Intent intent = new Intent(getActivity(), PizzaDetailActivity.class) 
intent.putExtra(PizzaDetailActivity.EXTRA—PIZZANO, position); 
getActivity().startActivity(intent); 


})； 

return layout; 


Most o-f the dodc is the same as 4v 

Pi 2 iaMatc\rialF\rag^ch-tjava. 
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fragment-top.xml 


The full code for fragmcwt_top.xml 

We’ve changed TopFragment so that it displays introductory text 
and two pizzas. We’ll show you the full code over the next couple of 
pages. 

First, add the following to strings, xml: 

<string name='▼ welcome 一 text”>We offer a range of freshly baked pizza and pasta 
dishes. Why not try some?</string> 


Then update fragment—top. xml with the following code: 



BitsAndPizzas 


app/sre/main 


<RelativeLayout xmlns : android= n http : //schemas.android.com/apk/res/android" 
xmlns : tools="http : //schemas.android.com/tools" 
android:layout_width="match_parent M 
android:1ayout_height= M match_parent" 
android:paddingTop="16dp" 
android:paddingBottom= M 16dp n 
android:paddingRight="16dp" 
android:paddingLeft="16dp" 

tools : context:”.MainActivity n > res 


<TextView layout ― 

android: layout—width: n match_^parent n </^ij 

android: layout_height= n wrap—content" fragment_top.xml 

android:text= n @string/welcome—text” 

android:id= M @+id/welcome text" /> 」 

一 \ WcVc addi'm) a Tc%tv»c>M 

-to lay 



/oui 


<android.support.v7.widget.RecyclerView 
android: id= n @+id/pizza_recycler’▼ 
android:scrollbars= n vertical" 


android:layout—width:"match_parent n 
android:layout— height= n wrap—content” 
android:layout_below="@+id/welcome_text" 
android:layout—marginTop= n 10dp n /> 
</RelativeLayout> 


On the next page, we’ll show you the code for TopFragment.jam. 


644 Chapter 14 











material design 


The full code for TopFragmewt.java 

package com.hfad.bitsandpizzas; 


r"v 



import android.content.Intent; 
import android.os.Bundle; 
import android.app•Fragment; 

import android.support.v7•widget.GridLayoutManager; 
import android. support. v7 • widget. RecyclerView ; 
import android.view.LayoutInflater; 
import android.view.View; 
import android. view. ViewGroup; tldsscs. 

import android.widget.RelativeLayout; 



BitsAndPizzas 


app/sre/main 

L D 

java 



com.hfad.bitsandpizzas 


b l tlat« 

Id 


TopFragment.java 


public class TopFragment extends Fragment 


@Override 

public View onCreateView(Layoutlnflater inflater, ViewGroup container. 

Bundle savedlnstanceState) { 


RelativeLayout layout = (RelativeLayout) 


inflater.inflate(R.layout.fragment_top, container, false); 
RecyclerView pizzaRecycler = (RecyclerView)layout.findViewByld(R.id.pizza_recycler); 
String[] pizzaNames = new String[2]; 
for (int i = 0; i < 2; i++) { 

pizzaNames[i] = Pizza.pizzas[i].getName(); 


int[] pizzalmages = new int[2]; 
for (int i = 0; i < 2; i++) { 


Cwte arrays 4\r the fiz^ a^d \^cs. 


pizzalmages[i] = Pizza.pizzas[i].getImageResourceId(); 

} ^ ,s ?l a Y 七 k m a 

GridLayoutManager layoutManager = new GridLayoutManager(getActivity(),2); 


pizzaRecycler.setLayoutManager(layoutManager); 


CaptionedlmagesAdapter adapter = new CaptionedlmagesAdapter (pizzaNames , pizzalmages) 
pizzaRecycler.setAdapter(adapter); ^ 

adapter•setListener(new CaptionedlmagesAdapter.Listener() { 
public void onClick(int position) { 

Intent intent = new Intent(getActivity(), PizzaDetailActivity.class); 
intent.putExtra(PizzaDetailActivity.EXTRA—PIZZANO, position); 
getActivity().startActivity(intent); 


Ksc the adap-tev -to 
display the piz^ds. 


})； 

return layout; 


Start Piz^aPcta'ilA^WitY user dkks cm a 
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another test drive 

Test drive the app 

Let’s see what happens when you run the app. 



Bits And Pizzas 



We offer a range of freshly baked pizza and pasta 
dishes. Why not try some? 



<-Pizza Detail 




Funghi 


Diavolo 


Funghi 


Two pizzas av-c displayed 
\y\ a yid. you c\\tV- 
ov\ a its details art 
disflaycd. 



text and two of the pizzas. When you click on a pizza, its 
details are displayed in Pi zzaDe tail Activity. 
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Your Android Toolbox 

You’ve got Chapter 14 under 
your belt and now you’ve 
added Material Design to your 
tool box. 


You c^y\ download 
-full code ^OV 

Wt 切 

HcadPtv-stA^dvoid. 



BULLET POINTS 


■ Card views and recycler views have their 
own support libraries. 


■ 


■ 


Add a card view to a layout using 

the <android.support. 
v7 . widget. CardView> element. 

Give the card view rounded corners using 

the cardCornerRadius attribute. 
This requires a namespace of "http ： // 

schemas.android.com/apk/ 
res-auto". 

■ Recycler views work with adapters that 
are subclasses of RecyclerView. 
Adapter. 


■ 


When you create your own 

RecyclerView. Adapter, you must 
define the viewHolder and implement 

the onCreateViewHolder(), 
onBindViewHolder () , and 
getltemCount () methods. 


■ 


■ 


You add a recycler view to a layout 
using the <android. support. 
v7.widget.RecyclerView> 
element. You give it a scrollbar using the 

android : scrollbars attribute. 

Use a layout manager to specify how 
items in a recycler view should be 
arranged. A LinearLayoutManager 
arranges items in a linear list, 

aGridLayoutManager 

arranges items in a grid, and a 

StaggeredGridLayoutManager 

arranges items in a staggered grid. 
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have fun 


Leaving toww... 



Ifs been great having you here m Androidville 


We’re Sad to see you leave, but there’s nothing like taking what you’ve learned 
and putting it to use. There are still a few more gems for you in the back of the book and 
an index to read through, and then it’s time to take all these new ideas and put them into 
practice. Bon voyage! 
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fThe Android Runtime ♦ 



Android apps need to run on devices with low-powered 
processors and very little memory. 

Java apps can take up a lot of memory, and because they run inside their own Java Virtual 
Machine (JVM), Java apps can take a long time to start when they’re running on low- 
powered machines. Android deals with this by not using the JVM for its apps. Instead, it 
uses a very different virtual machine called the Android runtime (ART). In this appendix, 
we’ll look at how ART gets your Java apps to run well on a small, low-powered device. 
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ART vs JVM 


What is the Android runtime (ART)? 


The Android runtime (ART) is the system that runs your compiled code on 
an Android device. It first appeared on Android with the release of KitKat 
and became the standard way of running code in Lollipop. 

ART is designed to run your compiled Android apps quickly and efficiently 
on small, low-powered devices. 


ART is very different from the JVM 


Java has been around for a very long time, and compiled Java programs 
have almost always run on Oracle’s Java Virtual Machine (JVM). The 
JVM simulates a GPU chip, and it reads a compiled .class file that contains 
JVM machine code instructions called bytecodes. Traditionally you would 
compile .java source files into . class files. You would then run these using the 
JVM interpreter. 


souvdc is 
Compiled ih*to 
•dass -files. 


Foo{| 

o 


.java 


loot 

moiooi 

ooioloi 

loioilj 

_ —^ 

.class 


ART is very different. When you compile an Android application, 
everything starts in the same way. You write .java source files and compile 
them into . class files, but then a tool called dx will convert the set of . class 
(or .jar archives) into a single file called classes, dex. 



.java 


IOOI b| 


tool Di 

IIIOIOO 


moiod ^： 

00\0\0\ 


ooioicn 

loiomj 

1 

lololllj 

_ 

.class 

classes.dex 


The build pvodess 
sii-Uhes all ihc dass 
•files nvto a 
dasses.dex -Pile. 


This classes, dex file also contains bytecodes, but they are different from the 
bytecodes in a . class file. The .dex bytecodes are for a completely different 
virtual processor called Dalvik. In fact, dex stands for Dalvik Executable. 

The Dalvik processor is kind of similar to the JVM. Both the JVM and 
Dalvik are virtual processors. They are both theoretical chips. But the 
Oracle JVM is a stack-based processor and Dalvik is a register-based 
processor. Some people believe that code for register-based processors 
can be tuned to be smaller and to run faster. By converting a whole set 
of different files into a single classes, dex file, the dx tool is able to make 
the compiled app a lot smaller because it can remove a lot of duplicated 
symbols that might appear in many . class files. 
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ART 


The classes, dex file is then compressed with a bunch of other resource 
and data files into a ZIP-compressed file called an application 
package or APK file. The .apk file is the final compiled application 
that can be installed on an Android device. This is the file that you’ll 
eventually upload to the Google Play Store. 


app is 

-Pv- 

.jdvd 

sou\rdc -Piles. 



.java 


The java -files 
avc dorwcvtcd 
m*to 

.^Idss -f iles. 



loot 

moiool 

oololol 

IOIOIII i 

_ 

.class 


The build p\rodcss 
sti-Uhcs all ihc dass 
-files m-fco a 
dlasses.dex. -file. 





classes.dex 


How Android runs aw APK file 


tlasscs.de% is 
s*to\rcd mside a 
ZIP av-tiiivc tailed 
dr\ apflidatior^ 



.apk 


The APK file is just a ZIP-compressed archive. When it’s transferred 

to an Android device, it’s stored in a directory called /data/ 

app/<package name> and then the classes.dex file is extracted from it. 

When the classes.dex file is extracted from the APK archive, it’s 
converted into a native library. The Dalvik bytecodes become actual 
native machine code instructions that can be run directly by the 
device’s GPU. This compiled library is then stored in the /data/dalvik- 
cache directory. Android only needs to perform this native compilation 
step the first time that the app is run. From then on, the Android 
device can simply load and run the native library. 


Android is just a version of the Linux operating system, 
and Linux doesn’t normally have the ability to run 
Android apps. That’s why each Android device runs a 
process called Zygote. Zygote is like an Android process 
that is already up and running. When you tell Android 
to start a new Android app, Zygote will create a forked 
version of itself. A forked process is just another copy of 
the process in memory. Linux can fork processes very 
quickly, so by forking the Zygote process and then loading 
the native library, an Android app can be loaded very 
quickly. 



K 个 个 

Dalvik aff pv-odcss is -fov-ked 
-Pv-om i\\t pv-otess. 
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performance 


Performance and size 

Android devices usually have a lot less power and storage than 
machines that normally run Java code. ART uses .dex files that 
are normally smaller than their equivalent. class files. The Oracle 
JVM can compile some parts of the code it interprets using just- 
in-time compilation, which means that the JVM converts Java 
bytecode into machine code while it’s running the code. This is 
fine for applications that run for a very long time, like application 
servers, but Android applications might be started and stopped 
regularly. By compiling all of the Dalvik bytecodes into a native 
library ahead of time, ART ensures that it only needs to compile 
the code once. 

Finally, the Oracle Java runtime can take some time to start on 
low-powered devices. By using the Zygote process, Android is 
able to get apps up and running much more quickly. The Zygote 
process can also use shared memory to securely execute code that 
will be common to all Dalvik processes. 

Security 

An Android device might run code from many different 
developers, and it’s important that each app is completely isolated 
from every other app. Without that separation, one app might 
breach the security of any other app on the device. To ensure that 
apps are isolated, Android will run each app in a separate process, 
with an automatically generated user account. This allows apps 
to be isolated using operating system security provided by Linux. 
If the Oracle Java runtime was used, each process would require 
its own Java process, which would greatly increase the memory 
required to run several apps. 
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The Android Debug Bridge 


Why, darling, 
thafs so 
thoughtful. 


In this book, we’ve focused on using an IDE for all your 

Android needs. But there are times when using a command-line tool can be plain 
useful, like those times when Android Studio can’t see your Android device but you just 
know it’s there. In this chapter, we’ll introduce you to the Android Debug Bridge (or adb), 
a command-line tool you can use to communicate with the emulator or Android devices. 


this is an appendix 





adb 


adb: your command-line pal 

Every time your development machine needs to talk to an Android device, 
whether it’s a real device connected with a USB cable, or a virtual device 
running in an emulator, it does it by using the Android Debug Bridge 
(adb). The adb is a process that’s controlled by a command that’s also called 
adb. 

The adb command is stored in the plat form-tools directory of the 
Android System Developer’s Kit. On a Mac, you’ll probably find it in 
/Users/<username>/Library/Android/sdk/platform-tools. If you add platform- 

tools directory to your PATH, you will be able to run adb from the command 
line. 

In a terminal or at a command prompt, you can use it like this: 


| Interactive Session 


$ adb devices 


List of devices 

attached 

emulator-5554 

$ 

device 


The adb devices command means “Tell me which Android devices you 
are connected to”. The adb command works by talking to an adb server 
process, which runs in the background. The adb server is sometimes called 
the adb damon or adbd. When you enter an adb command in a terminal, a 
request is sent to network port 5037 on your machine. The adbd listens for 
commands to come in on this port. When Android Studio wants to run an 
app, or check the log output, or do anything else that involves talking to an 
Android device, it will do it via command port 5037. 


I^IJ 

adb command 



Device 


When the adbd receives a command, it will forward it to a separate adbd 
process that’s running in the relevant Android device. This will then be able 
to make changes to the Android device or return the requested information. 
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adb 


Sometimes, if the adb server isn’t running, the adb command will 
need to start it: 


Interactive Session 


$ adb devices 

* daemon not running. starting it now on port 5037 * 

* daemon started successfully * 

List of devices attached 
emulator-5554 device 


Likewise, if ever you plug in an Android device and Android 
Studio can’t see it, you can manually kill the adb server and restart 
it: 

I Interactive Session | 


$ adb devices 
List of devices attached 
$ adb kill-server 
$ adb start-server 

* daemon not running. starting it now on port 5037 * 

* daemon started successfully * 

$ adb devices 

List of devices attached 
emulator-5554 device 


By killing and restarting the server, you force adb to get back in 
touch with any connected Android devices. 
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adb 


Running a shell 

Most of the time you won’t use adb directly; you’ll let an IDE like 
Android Studio do the work for you. But there are times when it can be 
useful to go to the command line and interact with your devices directly. 

One example is if you want to run a shell on your device: 


| Interactive Session 


$ adb shell 
root@generic x86:/ # 



The adb shell command will open up an interactive shell directly on 
the Android device. The adb shell command will only work when 
there is a single Android device connected, otherwise it won’t know 
which Android device you want to talk to. 


Once you open a shell to your device, you can run a lot of the standard 
Linux commands: 


| Interactive Session 





$ adb shell 

root@generic x86:/ # 

acct 

cache 

charger 

config 

d 

data 

Is 




default.prop 
dev 





etc 

file contexts 





參參 •參 

1 | root@generic x86 :/ 

# df 




Filesystem 

Size 

Used 

Free 

Blksize 

/dev 

439.8M 

60. OK 

439.8M 

4096 

/mnt/asec 

439.8M 

0.0K 

439.8M 

4096 

/mnt/obb 

439.8M 

0.0K 

439.8M 

4096 

/system 

738.2M 

533.OM 

205.2M 

4096 

/data 

541.3M 

237.8M 

303.5M 

4096 

/cache 

65. OM 

4.3M 

60.6M 

4096 

/mnt/media rw/sdcard 

196.9M 

4.5K 

196.9M 

512 

/s torage/sdcard 
root@generic x86:/ # 

196.9M 

4.5K 

196.9M 

512 
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fret the output from logcat 

All of the apps running on your Android device sending their 
output to a central stream called the logcat. You can see the live 
output from the logcat by running the adb logcat command: 

["Interactive Session | 


$ adb logcat 

- beginning of system 

I/Void ( 936) : Void 2.1 (the revenge) firing up 

D/Vold ( 936) : Volume sdcard state changing -1 

(Initializing) - > 0 (No-Media) 

W/DirectVolume( 936) : Deprecated implied prefix pattern 

detected, please use '/devices/platform/goldfish 一 mmc•0*' 
instead 


The logcat output will keep streaming until you stop it. It can be 
useful to run adb logcat if you want to store the output in a 
file. The adb logcat command is used by Android Studio to 
produce the output you see in the Devices/logcat frame. 

Copying files to/from your device 

The adb pull and adb push commands can be used to 
transfer files back and forth. For example, here we are copying the 
/default.prop/ properties file into a local file called l.txt 


Interactive Session 


$ adb pull /default.prop l.txt 
28 KB/s (281 bytes in 0.009s) 

$ cat 1.txt 

# 

# ADDITIONAL 一 DEFAULT 一 PROPERTIES 

# ~ 
ro.secure=0 

ro.allow.mock.location=l 
ro.debuggable=l 
ro.zygote=zygote32 
dalvik. vm. dex2oat-Xms=64m 
dalvik.vm.dex2oat-Xmx=512m 
dalvik. vm. image - dex2oat-Xms=64m 
dalvik. vm. image - dex2oat-Xmx=64m 
ro.dalvik.vm.native.bridge=0 
persist.sys.usb.config=adb 
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adb 


And much, much more... 

There are many, many commands that you can run using adb: you 
can back up and restore databases (very useful if you need to debug 
a problem with a database app), start the adb server on a different 
port, reboot machines, or just find out a lot of information about 
the running devices. To find out all the options available, just type 
adb on the command line: 


in 


Interactive Session 


$ adb 

Android Debug Bridge version 1.0.32 

.-a „ - directs adb to listen on all 

terraces for a connection 

■d _ . . - directs command to the only 

returns an error if more than 
- directs command to the only 


connected USB device 

one USB device is present. 

-e 

running emulator. 
returns an error if more than one emulator is 
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fThe Android Emulator ♦ 



Ever felt like you were spending all your time waiting for the 
emulator? 

There’s no doubt that using the Android emulator is useful. It allows you to see how your 
app will run on devices other than the physical ones you have access to. But at times it 
can feel a little... sluggish. In this appendix, we’re going to explain why the emulator can 
seem slow. Even better, we’ll give you a few tips we’ve learned for speeding it up. 
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speed 


Why the emulator is so slow 


When you’re writing Android apps, you’ll spend a lot of 
time waiting for the Android emulator to start up or deploy 
your code. Why is that? Why is the Android emulator so 
sloooooow? If you’ve ever written iPhone code, you will 
know how fast the iPhone simulator is. If it’s possible for the 
iPhone, then why not for Android? 

There’s a clue in the name: the iPhone Simulator and the 
Android Emulator. 

The iPhone Simulator simulates a device running the iOS 
operating system. All of the code for iOS is compiled to run 
natively on the Mac and the iPhone Simulator runs at Mac- 
native speed. That means it can simulate an iPhone boot-up 
in just a few seconds. 

The Android Emulator works in a completely different way. 
An Android Emulator uses an open source application called 
(or 

hardware device. It runs code that interprets machine 
code that’s intended to be run by the device’s processor. It 
has code that emulates the storage system, the screen, and 
pretty much every other piece of physical equipment on an 
Android device. 


Quick Emulator) to emulate the entire Android 




AVD 

AVD 

AVD 

AVD 

AVD 


QEMU Emulator 


AH A^dro\d \/"iv-*tual Decides 

Oir> ddllcd 


v*ur> 


An emulator like QEMU creates a much more realistic 
representation of a virtual device than something like the 
iPhone Simulator does, but the downside is that it has to do 
far more work for even simple operations like reading disk or 
displaying something on a screen. That’s why the emulator 
takes so long to boot up a device. It has to pretend to be 
every little hardware component inside the device, and it has 
to interpret every single instruction. 
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the emulator 


How to speed up your Android development 

1. Use a real device 


The simplest way to speed up your development process is by using a real 
device. A real device will boot up much faster than an emulated one, and 
it will probably deploy and run apps a lot more quickly. If you want to 
develop on a real device, you may want to go into “Developer options” 
and check the Stay Awake option. This will prevent your device locking 
the screen, which is useful if you are repeatedly deploying to it. 


Z. Use m emulator snapshot 


Booting up is one of the slowest things the emulator does. If you save 
a snapshot of the device while it’s running, the emulator will be able to 
reset itself to this state without having to go through the boot-up process. 
To use a snapshot with your device, open the AVD manager from the 
Android Studio menu by selecting Tools^An droids AVD Manager, edit 
the AVD by clicking on the Edit symbol, then check the “Store a snapshot 
for faster startup” option. 

This will save a snapshot of what the memory looks like when the device 
is running. The emulator will be able to restore the memory in this state 
without booting the device. 


3. Use hardware acceleration 


By default, the QEMU emulator will have to interpret each machine 
code instruction on the virtual device. That means it’s very flexible 
because it can pretend to be lots of different GPUs, but it’s one of the 
main reasons why the emulator is slow. Fortunately, there’s a way to get 
your development machine to run the machine code instructions directly. 
There are two main types of Android Virtual Device: ARM machines and 
x86 machines. If you create an x86 Android device and your development 
machine is using a particular type of Intel x86 GPU, then you can 
configure your emulator to run the Android machine code instructions 
directly on your Intel GPU. 

Vrm will npprl tn Tntpl’q 1-T^rHw^rp Arrplpr^terl Rvprntirm A/l^rmcrpr 



accelerated-execution-manager 

HAXM is a hypervisor. That means it can switch your GPU into a special 
mode to run virtual machine instructions directly. HAXM will only run 
on Intel processors that support Intel Virtualization Technology. If your 
development machine is compatible, then HAXM will make your AVD 
run much faster. 
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The Top Ten Things 
(we didn’t cover) 




Even after all that, there’s still a little more. 

There are just a few more things we think you need to know. We wouldn’t feel right about 
ignoring them, and we really wanted to give you a book you’d be able to lift without 
extensive training at the local gym. Before you put down the book, read through these 
tidbits. 
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distribution 


1. Pistributiwg your app 

Once you’ve developed your app, you’ll probably want to make it 
available to other users. You’ll usually want to do this by releasing 
your app through an app marketplace such as Google Play. 

There are two stages to this: preparing your app for release, and then 
releasing it. 

Preparing your app for release 

Before you can release your app, you need to configure, build, and 
test a release version of your app. This includes tasks such as deciding 
on an icon for your app and modifying AndroidManifest. xml so that 
only devices that are able to run your app are able to download it. 

Before you release your app, make sure that you test it on at least one 
tablet and one phone to check that it looks the way you expect and its 
performance is acceptable. 

You can find further details of how to prepare your app for release 
here: 



Releasing your app 

This stage includes publicizing your app, selling it, and distributing it. 

To release your app on the Play Store, you need to register for a 
publisher account and use the Developer Console to publish your 
app. You can find further details here: 

http:/ / developer, android, com/distribute/googleplay/start, html 

For ideas on how to best target your app to your users and build a 
buzz about it, we suggest you explore the documents here: 

http:/ / developer, android, com/distribute/index, html 
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1 . Cowtcwt providers 

You’ve seen how to use intents to start activities in other apps. As 
an example, you can start the Messaging app to send the text you 
pass to it. But what if you want to use another app’s data in your 
own app? What if you want to use Contacts data in your app to 
perform some task, or insert a new Calendar event? 


You can’t access another app’s data by interrogating its database, 
Instead, you use a content provider. A content provider is an 
interface that allows apps to share data in a controlled way. It 
allows you to perform queries to read the data, insert new records, 
and update or delete existing records. 


If you want to 
access another app*s 
database, you have to 
go through me. 


O 



YourActivity 


Content 

Provider 


Database 


If you want other apps to use your data, you can create your own 
content provider. 

You can find out more about the concept of content providers 
here: 

http:/ / developer, android, com/guide/topics/providers/content- 
providers.html 

Here’s a guide on using Contacts data in your app: 

http:/ / developer, android, com/guide/topics/providers/contacts- 
provider.html 

Here’s a guide on using Calendar data: 

http:/ / developer, android, com/guide/topics/providers/ 
calendar-provider, html 
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3 . The WebView class 

If you want to provide your users with access to web content, you 
have two options. The first option is to develop a web app that 
users can access on their device using a browser. The second option 
is to use the WebView class. 


The WebView class allows you to display the contents of a web 
page inside your activity’s layout. You can use it to deliver an entire 
web app as a client application, or to deliver individual web pages. 
This approach is useful if there’s content in your app you might 
need to update, such as an end-user agreement or user guide. 


You add a WebView to your app by including it in your layout like 
this: 


<WebView xmlns : android="http :// schemas.android.com/apk/res/android 
android : id="@+id/webview" 
android : layout—width="match—parent" 
android : layout 一 height= n match—parent，' / > 

You tell it which web page to load using the loadUrl () method 
in your Java code like this: 

Webview webview = (WebView) findViewByld(R.id•webview); 
webview. loadUrl ( "http : // www. oreilly. com / ，， ）； 

You also need to specify that the app must have Internet access by 
adding the INTERNET permission to AndroidManifest.xmh 

〈manifest ... > 

<uses-permission android : name="android.permission.INTERNET" /> 

• •參 

〈 /manifest 〉 


You can find out more about using web content in your apps here: 

http:/ / developer, android, com/guide/webapps/index, html 
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4. Animation 

As Android devices use more of the power from their built-in graphics 
hardware, animation is being used more and more to improve the 
user’s app experience. 

There are several types of animation that you can perform in Android: 

Property animation 

Property animation relies on the fact that the visual components 
in an Android app use a lot of numeric properties to describe their 
appearance. If you change the value of a property like the height or 
the width of a view, you can make it animate. That’s what property 
animation is: smoothly animating the properties of visual components 
over time. 

View animations 

A lot of animations can be created declaratively as XML resources. 

So you can have XML files that use a standard set of animations (like 
scaling, translation, and rotation) to create effects that you can call from 
your code. The wonderful thing about declarative view animations is 
that they are decoupled from your Java code, so they are very easy to 
port from one app project to another. 


Activity transitions 


Let’s say you write an app that displays a list of items with 
names and images. You click on an item and you’re taken 
to a detail view of it. The activity that shows you more 
detail will probably use the same image that appeared in 
the previous list activity. 

Activity transitions allow you to animate view from one 
activity that will also appear in the next activity. So you 
can make an image from a list smoothly animate across 
the screen to the position it takes in the next activity. This 
will give your app a more seamless feel. 

To learn more about Android animation see: 

https:/ / developer, android, com/guide/topics/graphics/ 
index.html 

To learn about activity transitions and Material Design, see: 



Pizza Detail 


: unghi 


https:/ / developer, android, com/training/material/ 
animations.html 
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5 . Maps 

An Android device can go everywhere with you, and so location 
and mapping are important features in many Google apps. 

If you install the Google Play Services library, you can embed 
Google Maps directly into your app. It comes with the full 
power of the native app, plus you can do a huge amount of 
customization to make maps a fully integrated part of your app. 

You insert a map into a layout as a fragment: 

〈fragment xmlns : android="http :// schemas.android.com/apk/res/android" 
android:id= n @+id/map" 
android:layout_width= M match_parent" 
android:layout_height= n match_parent" 
android : name="com.google.android.gms.maps.MapFragment "/ > 


Then you can programmatically access the map from your code 
as a GoogleMap object: 



GoogleMap map = getMap(); 

And then you add your own features to the map. For example, 
you add polylines to it like this: 

routeLine = map.addPolyline(new PolylineOptions() 

.width(ROUTE—THICKNESS_PIXELS) 

.color(Color.RED)); 

This is ah app that has 6foo^\c 

/Waps (imbedded \v\ it 


TWis is a folyl'mc. 


7:36 


BuzzRoute 
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5. Maps (continued) 

You can also listen to events on the app. With an 
OnCameraChangeListener you can see when the 
user moves the map to a different location, and with an 
OnMapClickListener you can tell the latitude and 
longitude of the point on the map where a user just clicked: 

map.setOnCameraChangeListener(new OnCameraChangeListener() { 

QOverride 

public void onCameraChange(CameraPosition cameraPosition) 
// Dragged to a new place on the map 

} 

})； 

map.setOnMapClickListener(new OnMapClickListener() { 

QOverride 

public void onMapClick(LatLng latLng) { 

// Clicked at a latitude/longitude latLng 

} 

})； 

To find out more about Google Maps and how you can 
integrate them with your Android app, go to: 

https:/ / developer, android, com/google/play-services/maps, 
html 

6. Cursor loaders 

If you do much work with databases or content providers, 
sooner or later you’ll encounter cursor loaders. A cursor loader 
runs an asynchronous query in the background and returns 
the results to the activity or fragment that called it. It manages 
your cursor for you so that you don’t have to. It also notifies 
you if the data changes so that you can deal with it in your 
views. 

You can find out more about cursor loaders here: 

https:/ / developer, android, com/training/lo ad- data- 
background/setup-loader.html 
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7. broadcast receivers 

Suppose you want your app to react in some way when a system 
event occurs. You may, for example, have built a music app, and 
you want it to stop playing music if the headphones are removed. 
How can your app tell when these events occur? 

System events include things like the device running low on power, 
a new incoming phone call, or the system getting booted. Android 
broadcasts these system events when they occur, and you can listen 
out for them by creating a broadcast receiver. Broadcast receivers 
allow you to subscribe to particular broadcast messages. This 
means that you can get your app to respond to system events. 


The battery’s 
running low, in case 
any ones interested. 


O 




Hey, Activity, Android 
says the battery's 
running low on power. 

O 

o 


\nj 

Android 


P 



Broadcast 

Receiver 


OK, I’ll hold off 
on expensive 
tasks for now. 


O 


o 



YourActivity 


You can find out more about broadcast receivers here: 

http:/ / developer, android, com/reference/android/content/ 
BroadcastReceiver. html 
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%. App widgets 

An app widget is a small application view that you can add 
to other apps or your home screen. It gives you direct access 
to an app’s core content or functionality from your home 
screen without you having to launch the app. 

Here’s an example of an app widget: 


(5 00:00 
0.00 KM 
0:00 KM/H 



TV^is is aff Vidyt It jWcs you 
^ dwtci adtcss -to aff s tort 


START 


To create an app widget, you need an AppWidgetProviderlnf o 
object, an AppWidgetProvider class implementation, and a 
View layout. The AppWidge t Provider Inf o object describes 
metadata for the widget, such as its AppWidget Provider class 
and layout. It’s defined in XML. The AppWidget Provider class 
implementation contains the methods that you need to interface with 
the app widget. The View layout is an XML layout that describes 
how the app widget should look. 


To find out how you create your own app widgets, look here: 


http:/ / developer, android, com/guide/topics/app widgets /index • 
html 
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9. NiwePatch graphics 

A NinePatch graphic is a stretchable bitmap you can use as a 
view’s background. The image is automatically resized depending 
on the contents of the view and the size of the screen. The clever 
bit is that you define which areas should stretch, and which areas 
shouldn’t. 

As an example, suppose you wanted to use the following image as 
the background of a button: 



You need the image to be able to stretch so that it can 
accommodate different lengths of text, but you don’t want the 
edges of the image to get distorted as it stretches: 



This dv~ed should or>ly s'iz^ 

hovizo^tally. You do^*t >wa 於七 ’I 七 *to yt 
-tallcv-, as 七 ha 七 would d*is*fco\rt imay. 


TVis area should o^ly 
^ sizjC vcy-t^ally- 
I 七 shouldn’t yt w'idcv-. 


If you turn the image into a NinePatch graphic, you can get the 
image to stretch exactly how you want. 

Android includes a tool called the Draw 9-patch tool that helps you 
create NinePatch images. You can find out more about the Draw 
9-patch tool and NinePatch graphics in general by following this 
link: 

http:/ / developer, android, com/guide/topics/graphics/2d- 
graphics. html#nine-patch 
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10. Testing 

All modern development relies heavily on testing, and Android comes with 
a lot of built-in support. As the main Android language is Java, you can use 
the standard Java testing frameworks, but Android takes things a whole step 
further by including a testing framework right in the SDK. In fact, Android 
Studio automatically creates a file hierarchy for tests every time you create a 
project. 

Android testing is based on JUnit, with extensions specially built for Android. 
You can use AndroidTestCases for basic component testing. The 
framework includes mocks for objects like Intents and Contexts to 
make the testing of an individual component easier. 

There’s also a special App 1 i cat ionTestCase that’s useful for testing 
that the basic configuration of files like AndroidManifest.xml is set up correctly. 

The most impressive thing in the basic test framework is Instrumentation 
Testing. Android apps can be instrumented so that the interactions between a 
component and the operating system can be monitored and changed. This 
means that you can run tests directly on a device that can call the lifecycle 
methods of an activity and fire off intents to the operating system. 

To find out more about the Android testing framework, go here: 

http:/ / d. android, com/tools/testing/testing_android. html 

For more advanced scenario testing, you should look at the Robotium 
testing framework. Robotium builds on the instrumentation testing used 
in the basic Android framework, and takes it to a whole new level. With 
Robotium you can write test code that almost reads like the test scripts that 
manual testers perform. 

For more information on Robotium go to: 

https:/ / code.google. com/p/robotium/ 
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specifying action 97-107 
on stopwatch app 128 
passing to Android 87 
pending 560 

putting extra information in 88 
retrieving data from 260 
sharing content with 386 
specifying content with 388 
starting activities using 83,95 


IntentService class ， 544-545 
interactive apps, building 
about 39-41 
connect activity 55-58 
creating project 40-42 
default activity and layout 43 
updating layout 44-54 
adding components with design editor 44-45 
adding values to spinner 53-54 
buttons and text in View class 45-47 
changes to XML 48-49 
using string resources 50-51 
write logic 59-71 
accessing text view methods 60 
building custom Java class 66-68 
first version of activity 63-65 
referencing text views 59-60 
retrieving values in spinner 60 
second version of activity 69-71 
setting text in TextView 60 
int values, retrieving 88 
invalidateOptionsMenu() method 418 
isClickable() method 203 
isFocused() method 203 
itemClicked() method 298 
item element 
attributes in 377-378 
modifying properties of theme using 373 
sharing action using 387 


Java 

activities 2 

files in folder structure in Android Studio project 16 
installing 6 
purpose of 2 
resource files 2 
source code in APK file 30 
using to develop Android apps 4 
Java classes, building custom 66-68 
Java Development Kit (JDK), installing 6 
java folder, in gradle projects 17 
Java Runtime Edition (JRE)，installing 6 
Java SE 4 

Java Virtual Machine (JVM) 
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Android Runtime vs. 650 
emulator vs. physical device 113 
overhead of 30 

L 

label attribute 372, 385 
layout_above attribute 171 
layout_alignB ottom attribute 171 
layout_alignLeft attribute 171 
layout_alignParentB ottom attribute 169 
layout_alignParentLeft attribute 169 
layout_alignParentRight attribute 169 
layout_alignParentTop attribute 169 
layout_alignRight attribute 171 ， 183-184 
layout_alignTop attribute 171 
layout_below attribute 171 
layout_centerHorizontal attribute 169 
layout_centerInParent attribute 169 
layout_centerVertical attribute 169 
layout_column attribute 193,194 
layout_columnSpan attribute 194 
layout files 
changing 

activity_main .xml file 32-33 
to use string resources 51 
referencing strings in 34 
layout folder 
in gradle projects 17 
in interactive apps 43 
layout_gravity attribute 183,193,406 
layout_height attribute 45, 166, 174-175,405-406 
layout-large folders 308 

Layout Magnets exercise, center Send Button in grid 
layout 195,224 
layout manager 615-616 
layout_marginBottom attribute 172 
layout_marginLeft attribute 172 
layout_marginRight attribute 172 
layout_marginTop attribute 172 
layout_row attribute 193 
layouts 
about 2, 38 

as hierarchy of views 204 
creating 15 

determining extra space views take up 180 


device app 

determining which layout device is using 320 
different folder options 309 
layouts for phone 315-316, 319 
layouts for tablets 314 
phone vs. tablet 306-307 
putting screen-specific resources in folders 308 
running code 320-321 
file code exercise 19-20 
for StopwatchFragment 335-336 
frame 300 
grid 

about 165 

adding views to 190 
creating new 191-195 
displaying views in 189 
full code for 196 
sketching 192 
summary for creating 197 
GUI components and 47-49, 201 
hint text , 177 

in multiple activities app 79, 86-87 
interactive app 
about 40 
default 43 

limitations of design editor in 52 
linear 
about 165 

adding weight to views 178-180 
changing basic 176-181 

displaying views in order they appear in layout XML 
174 

displaying views in single row or column 174 
full code for 185-186 
making stretch by adding weight in 178 
summary for creating 186 
using gravity attribute in view 181 ， 184 
using layout_gravity attribute in views 183-184 
relative 
about 165 
adding padding 167 

displaying views in relative positions 166 
positioning views relative to other views 170-171 
positioning views relative to parent layout 168-169 
summary for creating 173 
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using margins to add distance between views 172 
setting width and height 166 
ViewGroup and 
about 203-204 
layout XML converted to 204 
relative layout as 204 
working with activities 12 
layout_toLeftOf attribute 171 
layout_toRightOf attribute 171 
layout_weight attribute 178-180 
layout_width attribute 45,166,174-175,405-406 
layout XML 204 
leanback library, vl7 369 
left value 182,184 
libraries 
about 3 

CardView v7 602 

in folder structure in Android Studio project 16 
RecyclerView v7 602 
using support 369-370 
linear layout 
about 165 

adding weight to views 178-180 
changing basic 176-181 
displaying views in 
order they appear in layout XML 174 
single row or column 174 
full code for 185-186 
making stretch by adding weight in 178 
using gravity attribute in view 181 ， 184 
using layout_gravity attribute in views 183-184 
LinearLayoutManager 615 
Linux kernel 3 
ListActivity class 248 
listAdaper 291 
listener, event 

implementing 241,244,256-257 
set to ListView 242 
ListFragment class , 288-291 
ListView 

advantages of using 248 
binding listAdaper to 291 
creating list activity 249 
display list of options using 239 
in DrawerLayout 405-406 
navigating to data using 231 


reading data 495 
RecyclerView vs. 631 
replacing array data in 494 

responding to clicks with listener 241,244,256-257 
set listener to 242 

using AdapterView class with 251,291,407 
LocationListener 576-578 
logcat, viewing 546 
Log.d () method 546 
Log.e() method 546 
logging messages 546 
Log.i() method 546 
Log.v() method 546 
Log.w() method 546 
Log.wtf() method 546 

M 

Main Activity .j ava 
controlling what app does 31 
default support library 370 
implementing WorkoutListFragment interface 298 
in gradle projects 17 
in Workout app 279 
in WorkoutListFragment 293, 302 
phone layout 315 
main event thread 526 
maps, embedding 668-669 

margins, adding distance between views using 172 
match_parent setting 166 
match_parent value 175 
Material Design 
about 597-599 
card views 599-600 
Pizza app using 
adding data 601 
adding Pizza class 601 
adding support libraries 602 
changing TopFragment 639, 644-646 
creating CardView 603-604 
PizzaDetailActivity 627-630, 638, 646 
RecyclerViews. See RecyclerViews 
3D in 599 

Material themes 368, 371, 374, 385 
Maven 7 

MAX() functions 481 

menu elements, action items described in 377 
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menu resource file 
defining action items in 377 
inflating 380 
meta-data element 392 
methods 
add() 301 

addToBackStack() 301 
beginTransaction() 341 
bindService() 588 
changeCursor() 523 
close() 489 
closeDrawer() 413 
commit() 301 

createChooser() 108-109,113 
delete() 450 
delete() method 510 
distanceTo() 576 

doInBackground() 530, 532-536, 539 
execSQL() 466 
execute() 536 

findFragmentById() 281,287 
findFragmentByTagO 427-428 
findViewById() 60-61 ， 63-64,203,287, 327 
getActionBar() 393 
getBrands() 55, 66-68,70 
getChildFragmentManager() 339 
getDescription() 275 

getFragmentManager() 281,337-343,428 

getHeight() 203 

getld() 203,349 

getlnt() 489 

getlntent() 88,260 

getIntExtra() 88 

getItemCount() 606 

getListView() 248,289 

getMiles() 569,579,585,589, 593 

getname() 275 

getOdometer() 573 

getPendingIntent() 560 

getReadableDatabase() 484-486 

getSelectedItem() 60, 63, 65 

getString() 111,489 

getStringExtra() 92 

getSystemService() 561,578 

getView() 285 

getWidth() 203 

getWritableDatabase() 484-485 


insert() 448,510 
invalidateOptionsMenu() 418 
isClickable() 203 
isFocused() 203 
itemClicked() 298 
Log.d () 546 
Log.e() 546 
Log.i() 546 
Log.v() 546 
Log.w() 546 
Log.wtf() 546 
moveToFirst() 488 
moveToLast() 488 
moveToNext() 488 
moveToPrevious() 488 
onActivityCreated() 283, 327 
onAttach() 283,296, 327 
onB ackStackChanged() 426 
onBind() 571,573,575,592 
onBindViewHolder() 606, 609-610, 632 
onClick() 349-350, 549-550,634-635 
onClickFindBeer() 58-59, 61-62, 64-65, 70 
onClickReset() 120-122, 349-350 
onClickStart() 119,121-122, 349-350 
onClickStop() 120-122, 349-350 
onConfigurationChanged() 421 
onCreate() 
about 57,161 

adding new table column 462 
as Service class method 575, 577, 589 
calling 156 

calling in creating database 447,469 
constructor vs. 129 
enabling icon in action bar 420 
enabling up button 393 
fragments layout and 283 
in activity life cycle 133,143, 151-153, 327 
in adding favorites column 509 
in creating fragments 281 
in multiple activities app 77, 92 
in RecyclerView 619-621 
in SQLite helper 444 
in stopwatch app 117,129 
on rotated device 131,356 
SQLite helper 456-459 
updating action bar 425 
onCreateOptionsMenu() 380, 382, 376 


you are here ► 687 




the index 


onCreateView() 283,290, 327, 351,357 
onCreateViewHolder() 606 
onDestroy() 133-134, 143, 152-153,161,283,327, 
575 

onDestroyView() 283, 327 
onDetach() 283, 327 
onDowngrade() 455-456,461,469 
onDowngrade() method 458-459 
onDrawerClosed() 418 
onDrawerOpened() 418 
onFavoriteClicked() 510, 529, 536 
onHandleIntent() 544-545, 552-553 
onltemClickO 241,256-257,408 
onltemClickListenerO 241,256-257,264,408, 517, 
631 

onListltemClickO 248,256-257, 265,289 
onLocationChanged() 576 
onOptionsItemSelected() 376, 381-382,420 
onPause() 150-156,161,283,327 
onpostCreate() 421 
onPostExecute() 530, 534-535, 539 
onPreExecute() 530-531,539 
onPrepareOptionsMenu() 418 
onProgressUpdate() 530, 533, 535, 539 
onRestart() 142-143, 149, 161,327,523 
onResume() 150-155, 161,283, 327 
onSaveInstanceState() 137-138, 304, 355,425 
onSendMessage() 77, 84, 93, 99, 111 
onServiceConnected() 587 
onServiceDisconnected() 587 
onStart() 142-144,148-149, 156,161,283,285-286, 
327,588 

onStartCommand() 553, 575 

onStop() 142-144,147-148,161,283, 327,588 

onUpgrade() 444,455-456,458-460,469 

post() 124-125,552 

postDelayed() 124-125 

publishProgress() 533,539 

put() 448 

putExtra() 88 

query() 477-480, 484 

remove() 301 

replace() 427 

requestFocus() 203 

requestLocationUpdates() 578 

runTimer() 


creating 123 
in rotated device 131 
in stopwatch app 125,129,139,148,155 
updating stopwatch 121 
selectltem() 411,414 
setActionBarTitle() 412,426 
setAdapter() 253 
setContentIntent() 560 
setContentView() 129,249,278-279, 356 
setDisplayHomeAsUpEnabled() 393 
setItemChecked() 426 
setOnClickListener() 351 
setShareIntent() 388 
setText() 60 
setTransition() 301 
setVisibility() 203 
setWorkout() 280 
SQLiteDatabase query() 477 
start Activity () 83,99,113,117 
startService() 550 
superclass 144 
syncState() 421 
tostringO 275 
toStringO 253 
unbindService() 588, 593 
update() 449, 510, 532 
updateMyDatabase() 462 
ViewById() 59 
watchMileage() 589, 593 
MIN() functions 481 

minimum SDK (Software Development Kit) 
in API level 17 apps 370 
in basic apps 10 
in interactive apps 42 
mipmap image 372 
moveToFirst() method 488 
moveToLast() method 488 
moveToNext() method 488 
moveToPrevious() method 488 
mplicit intents 99 
multiple activities app 
about 73-75 

creating AndroidManifest file 80 
creating project 75-77 
intents and 
about 95-96 
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creating chooser 108-112 
displaying activity chooser dialog 100 
intent filters 101-102,113 
no matching activities 113 
running app on devices 105-106,113 
specifying action 97-107 
second activity 
AndroidManifest file 78-81 
calling second 82-85 
creating 78-81 
declaring activities in 81 
passing data to 86-94 

N 

name attribute 373, 548 
navigation drawers 
about 397-398,507 
ActionBarDrawerToggle 416-423 
adding 

DrawerLayout 405 
fragments 399-404 
tags to fragments 427 
closing 413 
code for 429-436 
creating 406-407 

dealing with configuration changes 425 
finding fragments using tags 428 
reacting to changes in back stack 426 
responding to clicks in list view 408-413 
title and fragment getting out of sync 424 
nested fragments 
about 325 

adding StopwatchFragment to WorkoutDetailFragment 
337-343 

attaching onClickListener to buttons 351 
code for 332-334,352-354,358-359 
creating 326 

error output for buttons in 345-346 
implementing onClickListener 349 
implementing StopwatchFragment onClick() method 
349-350 

needing nested transactions 341-342 
onClick attribute and 347-348 
rotating device containing 355-357 
nested transactions 341-342 


New Project Screen (Android Studio) 9-10 
NinePatch graphics 672 
non-static data, array for 250 
notification service 556-566 
about 543,556-557 
code for 562-566 
creating 558 

sending notification using 561 
starting activity using 559-560 
nullColumnHack String value 448 
NUMERIC data type 446 

o 

odometer app 
about 569-570 

binding to bound service 572-573 
binding to service 586-588 
creating project 569-570 
displaying distance traveled 589-594 
getting distance device travels 574-578 
getting miles for distance 579-582 
OdometerService 570, 580-581 ， 592-593 
onActivityCreated() method 283, 327 
onAttach() method 283, 296, 327 
OnB ackStackChangedListener 426 
onB ackStackChanged() method 426 
OnBackStackListener 428 
onBind() method 571,573, 575,592 
onBindViewHolder() method 606, 609-610, 632 
onclick attribute 56 

onClick attribute 347-348, 359, 508, 510 
onClickFindBeer() method 58-59, 61-62, 64-65,70 
onClickListener 349, 351, 359 
onClick() method 349-350, 549-550, 634-635 
onClickReset() method 120-122, 349-350 
onClickStart() method 119, 121-122, 349-350 
onClickStop() method 120-122, 349-350 
onConfigurationChanged() method 421 
oncreate() method 57 
onCreate() method 
about 161 

adding new table column 462 
as Service class method 575,577, 589 
calling 156 

calling in creating database 447,469 
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constructor vs. 129 
enabling icon in action bar 420 
enabling up button 393 
fragments layout and 283 

in activity life cycle 133, 137-141 ， 143, 151-153,327 
in adding favorites column 509 
in creating fragments 281 
in multiple activities app 77,92 
in RecyclerView 619-621 
in SQLite helper 444 
in stopwatch app 117,129 
on rotated device 131,356 
SQLite helper 456-459 
updating action bar 425 
onCreateOptionsMenu() method 380, 382, 376 
onCreateViewHolder() method 606 
onCreateView() method 283,290, 327, 351,357 
onDestroy() method 133-134,143,152-153,161,283, 
327,575 

onDestroyView() method 283, 327 
onDetach() method 283, 327 
onDowngrade() method 455-456,458-459,461 ， 469 
onDrawerClosed() methods 418 
onDrawerOpened() method 418 
onFavoriteClicked() method 510, 529, 536 
onHandleIntent() method 544-545, 552-553 
onItemClickListener() method 241 ， 256-257, 264, 408, 
517 

OnltemClickListener() method 631 
onItemClick() method 241,256-257,408 
onListItemClick() method 248,256-257, 265, 289 
onLocationChanged() method 576 
onOptionsItemSelected() method 376, 381-382,420 
onPause() method 150-156,161,283, 327 
onpostCreate() method 421 
onPostExecute() method 530, 534-535, 539 
onPreExecute() method 530-531,534, 539 
onPrepareOptionsMenu() method 418 
onProgressUpdate() method 530, 533,535, 539 
onRestart() method 142-143,149,161,327, 523 
onResume() method 150-155,161,283, 327 
onSavelnstanceState() method 137-138, 304, 355,425 
onSendMessageQ method 77, 84, 93,99, 111 


onServiceConnected() method 587 
onServiceDisconnected() method 587 
onStartCommand() method 553, 575 
onStart() method 142-144,148-149,156,161,283, 
285-286,327,588 

onStop() method 142-144,147-148,161,283, 327, 
588 

onUpgrade() method 444,458-460,462,469 
onUpgrade() methods 455-456 
orderlnCategory attribute 377-378 
ordering data, using queries for 480 
organizing ideas. See also Starbuzz app 
about 228 

types of activity categories 
about 229 

navigating through 230 
using ListViews to navigate to data 231 
orientation attribute 174 

P 

packages 
naming 9 
wizard forming 9 
padding, adding to layout 167 
Params parameter, AsyncTask defined by 530, 535 
parent Activity N ame attribute 392 
parent attribute, style inheriting properties from 373 
parent layout 
about 165 

positioning views relative to 168-169 
pending intents 560 
phones, device app layouts for 
about 306-307 

determining which layout device is using 320 
layouts for 315-316, 319 
putting screen-specific resources in folders 
about 308 

different folder options 309 
running code 320-321 
pixels, density independent 166 
Pizza app 

adding action items to action bar 
defining action items 377-379, 380 
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reacting to item clicks 381 
adding DrawerLayout 405-406 
bringing content forward 639 
changing MainActivity to use Activity class 371 
code for 389-390,406 
creating 

DrawerLayout 406-407 
order activity 382-383, 384-385 
PastaFragment 403 
PizzaFrament 401 
StoresFragment 404 
TopFragment 401 

defining styles in style resource files 373 
enabling up navigation 391-394 
Material Design in 
about 597-599 
adding data 601 
adding Pizza class 601 
adding support libraries 602 
card views 599-600 
changing TopFragment 639, 644-646 
creating CardView 603-604 
PizzaDetailActivity 627-630,638, 646 
RecyclerViews. See RecyclerViews 
3D in 599 
navigating 366-367 
navigation drawers 
about 398-399 

ActionB arDrawerToggle 416-423 
adding DrawerLayout 405 
adding fragments 399-404 
adding tags to fragments 427 
closing 413 
code for 429,429-436 
creating 406-407 

dealing with configuration changes 425 
finding fragments using tags 428 
reacting to changes in back stack 426 
responding to clicks in list view 408-415 
title and fragment getting out of sync 424 
running 375 

setting background color 406 
sharing content on action bars 386-388 
structure of 400 
support libraries in 370 


themes used in 371 

PizzaDetailActivity 627-630, 638, 646 
PizzaMaterialFragment 636-637 
Pool Puzzle exercises 

creating activity that binds Java array to spinner 255, 
267 

populating list view from DrinkCategoryActivity 
500-503 
putting code in 

CreateMessageActivity 89-90 
Detail Activity .j ava 317-318 
pop-up messages 220 
postDelayed() method 124-125 
post() method 124-125, 552 
primary key columns 446 

Progress parameter, AsyncTask defined by 530, 535 
public, making button 58 
publishProgress() method 533, 539 
putExtra() method 88 
put() method 448 

Q 

QEMU (Quick Emulator) 660-661 
queries, database 
about 476 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using cursor loaders in 669 
using SQL functions in 481 
query() method 477-480, 484, 486 

R 

RadioButton, as GUI component 212-213 
RadioGroup element 212-213 
R.drawable.image.name 236-237,268 
REAL data type 446 
ReceiveMes sage Activity 
about 78-79 
putting information in 88 
using information in intent using 92-93 
recyclerview library, v7 369 
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RecyclerView Magnets exercise, creating RecyclerView 
622-625 
RecyclerViews 
about 599-600 
adapter 
about 605 

adding interface to 634 
code for CaptionedlmagesAdapter 611 
creating 606 
creating constructor 609 
decoupling with interface 633 
keeping reusable 633 
ViewHolder for 607-610 
adding to layout 613 
arranging views 615-616 
creating 612 

fragment for 612-614, 617-618, 636-637 
implementing listener 636-637 
ListView vs. 631 
responding to clicks 631-638 
summary of code 619-621 
support libraries for 602 
refining apps 31-37 
relative layout, as ViewGroup 204 
Relative Layout element 46-47 
RelativeLayout element, in activity—main .xml 33, 38 
relative layouts 
about 165 
adding padding 167 

displaying views in relative positions 166 
positioning views relative 
to other views 170-171 
to parent layout 168-169 
summary for creating 173 

using margins to add distance between views 172 
remove() method 301 
renaming tables, SQLite databases 466 
render thread 526 
replace() method 427 
requestFocus() method 203 
requestLocationUpdates() method 578 
Reset button 

attaching onClickListener to 351 
in nested fragment code 346-350 
in stopwatch app 120,127 
in StopwatchFragment 336 


res folder 

in gradle projects 17 
in interactive apps 43 
resource files 
about 2 

in folder structure in Android Studio project 16 
Results parameter, AsyncTask defined by 530, 535 
right value 182,184 
R.java 17,59,65, 111 
root folder, in gradle projects 17 
running app, in Android emulator 23-30 
runTimer() method 
creating 123 
in rotated device 131 
in stopwatch app 125,129,139,148,155 
updating stopwatch 121 

s 

Safari Books Online xxxiv 
ScrollView, as GUI component 219 
SDK (Software Development Kit) 5 
selectltem() method 411,414 
SELECT statements 477,492 
Service class 544,571,575, 577 
service element 548 
Service Magnets exercises 
creating bound service 583-584 
creating started service 567-568 
services 
about 542 

bound. See bound services app 
started. See started services app 
setActionBarTitle() method 412,426 
setAdapter() method 253 
setContentIntent() method 560 
setContentView() method 129, 249,278-279, 356 
setDisplayHomeAsUpEnabled() method 393 
setDrawerListener() method 417 
setItemChecked() method 426 
setOnClickListener() method 351 
setShareIntent() method 388 
setText() method 60 
setTransition() method 301 
setVisibility() method 203 
setWorkout() method 280 
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ShareActionProvider 388-389 
Sharpen your pencil 
calling custom Java class 67-68 
changing app to linear layout 187-188 
choosing type of thread for block of code to run on 
527-528 

converting code to fragment 328-331 
determining results of onCreate() method 453-454 
restoring state of activity in activity life cycle 145- 
146 

writing code for TopFragment 641,643 
shortcuts, app 366-367 
show As Action attribute 378 
Sierra, Kathy Head First Java 4 
SimpleCursorAdapter 497 
Software Development Kit (SDK) 5 
sorting data, using queries for 480 
Spinner element 
about 48-49 
adding values to 53-54 
as GUI component 214 
attributes of 49 
spinners 

accessing methods with 60 
as type of view 202 
using AdapterView class with 251 
SQL functions, using in queries 481 
SQLite database. See also tables, SQLite 
about 437-439 
accessing other databases 440 
apps running slow on 
about 525-529,539 

AsyncTask performing asynchronous tasks 530-539 
changing 455 

changing Starbuzz app to use 473 
code for DrinkActivity 474, 490 
creating 472 

creating database 442-445 
creating tables 446-452 
CursorAdapters 
about 494 

closing database and 499 

mapping data using SimpleCursorAdapter to views 
497 

reading data 495-496 


close database and 489 
code for getting 486 
get database data with cursor 475 
getting values 489 
navigating 487-488 
downgrading 461 
DrinkActivity. See DrinkActivity 
DrinkCategoryActivity 493-506 
Drink table 

adding new column 462,465 
applying multiple conditions 450 
creating 447 
deleting 466 
deleting records 450 
inserting data 448 
renaming 466 
updating records 449 
getting reference to database 484-485 
JDBC and 440 
location of 439 
location of directory 440 
queries 
about 476 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using SQL functions in 481 
replacing array data in ListView 494 
SQLite helper decision tree on 459 
StarbuzzDatabaseHelper code 451-452 
structure of Starbuzz app 441-442 
upgrading 
about 457-460 

adding new table column 462,465 
code for 467-469 
deleting tables 466 
existing database 465-469 
renaming tables 466 
usernames and passwords 440 
version numbers 456-461 
SQLiteDatabase class 
about 440 

accessing database using 447 
as subclass of object 448 
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query() method defined in 484 
SQLiteDatabase query() method 477 
SQLiteExceptions 485,492 
SQLite helper 
about 437,443 
creating 444 

creating database 457-458 
decision tree 459 
for upgrading database 467-469 
onCreate() method 456-459 
StarbuzzDatabaseHelper code 451-452 
SQLite helper class 440,444 
SQLiteOpenHelper class 484 
SQLiteOpenHelper superclass 444-445,460-461 
SQL (Structured Query Language) 
creating tables using 447 
functions 481 
GROUP BY clauses 482 
HAVING clauses 482 
SELECT statements 477,492 
using execSQL() commands 466 
src folder, in gradle projects 17 
StaggeredGrid LayoutManager 615 
Starbuzz app 
about building 232 
adding Drink class 236 
adding resources 235-237 
app structure and steps 234-235 
creating project 235 
DrinkActivity. See DrinkActivity 
DrinkCategoryActivity 493-506 
drink detail activity 
about 233 
code for 263-266 
creating DrinkActivity 235 
displaying data for single record 259 
in app structure 234 
launching DrinkActivity 265 
retrieving data from intent 260 
updating views with data 261-262 
drinks category activity 
about 232,247 
adding array adapter 252 
creating DrinkCategory Activity 235,249 
full code for 258 
in app structure 234 


responding to clicks with listener 256-257 
starting DrinkCategory Activity 241,257 
working with data 250 
Drink table 

applying multiple conditions 450 
creating 447 
deleting records 450 
inserting data 448 
updating records 449 
image files for 237 
navigating through 233 
SQLite database. See SQLite database 
top level activity 
about 232 

adding favorites to. See top level activity 
creating TopLevelActivity 235 
full code for 243-244 
in app structure 234 
layout contents 238,240 
responding to clicks with listener 241,244,256 
set listener to ListView 242 
using wtih list views and spinners 251 
StarbuzzDatabaseHelper class 444 
startActivity() method 83, 99,113,117 
Start button 

attaching onClickListener to 351 
in nested fragment code 346-350 
in stopwatch app 119 
in StopwatchFragment 335-336 
started services app 
about 542 
creating 543 

displaying message in log 543-551 
about 543 
adding buttons 549 
ceatiing IntentService 544-545 
code for DelayedMessageService 547 
declaring services in AndroidManifest.xml 548 
logging messages 546 
starting service 550-551 
displaying message in notification 556-566 
about 543,556-557 
code for 562-566 
creating notification 558 
sending notification 561 
starting activity 559-560 
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displaying message in Toast 543, 552-555 
startService() method 550 
start value 184 
static data, array for 250 
Stop button 

attaching onClickListener to 351 
in nested fragment code 346-350 
in stopwatch app 120 
in StopwatchFragment 335-336 
stopwatch app 
about 118 
activity code of 121 
adding code for buttons 122 
building 118 

complete activity code 157 
converting code to fragment 328-334 
creating runTimer() method 123 
dealing with configuration changes 136-140 
formatting time on stopwatch app 127 
implementing onStop() method 144 
layout code for 119-120 
pausing and resuming 151-156 
reset 127 

restoring state of activity 147-149 
rotating device 131-132 
scheduling code 124-126 
working with activity code 121 
StopwatchFragment 

adding to WorkoutDetailFragment 337-343 
code for 332-334,352-354 
error output for buttons in 345-346 
layout for 335-336 
onClick attribute and 347-348 
onClick() method 349-350 
onCreateView() method 351 
Strings 

data type 489 

specifying conditions in queries as 479 
strings.xml 
adding 

chooser to 111 

code for ActionB arDrawerToggle 417 
code for TopFragment 401 
String resource to 508 

defining string-arrays 53-54, 65,72,239,402-404 
407 


in gradle projects 17 
in interactive apps 40,50,50-51 
in multiple activities app 77 
in stopwatch app 120 
in StopwatchFragment 336 
putting string values in 34-35, 37 
setting default theme in 374 
static array in 250 
up close 36 

Structured Query Language (SQL) 
creating tables using 447 
functions 481 
GROUP BY clauses 482 
HAVING clauses 482 
SELECT statements 477,492 
style element, defining styles in 373 
SUM() functions 481 
superclass methods 144,284-285,290 
Swing 4 

Switch element, as GUI component 209 
syncState() method 421 

T 

tables, SQLite 
creating 446-452 
data types 446 
Drink table 

adding new column 462,465 
applying multiple conditions 450 
creating 447 
deleting 466 
deleting records 450 
inserting data 448 
renaming 466 
updating records 449 
primary key columns in 446 
queries for 
about 477 

applying conditions to 478-479 
creating 477 
sorting data in 480 
specifying conditions as Strings 479 
specifying table and columns 478 
using SQL functions in 481 
StarbuzzDatabaseHelper code 451-452 
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using queries in 476 
tablets, device app layouts for 
about 306-307 

determining which layout device is using 320 
layouts for 314 

putting screen-specific resources in folders 
about 308 

different folder options 309 
running code 320-321 
TaskStackBuilder 559-560 
testing, apps 673 
text attribute 45,47,508 
TEXT data type 446 
TextView 

as GUI component 205 
as subclass of View class 202 
in activity—main .xml 33 
in Cardview 609-610 
in PizzaDetailActivity 627 
in Relative Layout element 47-48 
updating 86-87 
TextView class 
about 45 

referencing 59-60 
setting text in 60 
text views 
about 45-46 
attributes of 49 
referencing 59-60 
theme attribute 372-373 
themes, action bar 
about 368 

AppCompat 370-371 
applying in AndroidManifest.xml 372 
customizing 373 
Holo 368,371,374,385 
Material 368,371,374,385 
modifying properties of 373 
using on different levels different 385 
threads 

code running on which 529 
main event 526 
render 526 
types of 526 

time on stopwatch app, formatting 127 
title attribute 377 


Toast element 
as GUI component 220 
displaying message in 543, 552-555 
ToggleButton element, as GUI component 208 
TopFragment 
changing 639, 644-646 
creating 401 
top level activity 
about 229 

adding favorites to 507-525 
about 508 

adding column to cursor 509 
code for 513-514 
displaying favorites in 515-521 
putting important information in 507 
refreshing cursors automatically 522-525 
updating database by responding to clicks 510 
creating 235 
full code for 243-244 
in app structure 234 
in building Starbuzz app 232 
layout contents 238, 240 
navigating through 230 
Pizza app 
about 366-367 
changing top screen 639 
responding to clicks with listener 241,244, 256 
set listener to ListView 242 
structure of apps and 366-367 
top value 182,184 
tostring() method 275 
toString() method 253 

u 

unbindService() method 588,593 
Up button 391-394,420 
update() method 449, 510, 532 
updateMyDatabase() method 462 
USB debugging, enabling 105 
using Android action bar icon pack 379 

V 

v4 support library 369 
v7 appcompat library 369-371,378 
v7 cardview library 369 
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v7 gridlayout library 369 

v7 recyclerview library 369 

vl7 leanback library 369 

version numbers, SQLite database 456-461 

versions, Android 11 

ViewById() method 59 

View class 

buttons and text in 45 
GUI components as subclass of 202 
TextView as subclass of 202 
View methods used in 203 
ViewGroup class 202 
ViewGroup layouts 203-204 
ViewHolders 
creating 608 

defining RecyclerView adapters 607 
displaying image and caption 609 
views 

adding weight to 178-180 

advantages of being in a view 203 

determining extra space taken up by 180 

displaying in grid layout 189-190,193-195 

displaying in order they appear in layout XML 174 

displaying in relative positions 166 

displaying in single row or column 174 

layouts as hierarchy of 204 

mapping data to 497 

populating with data 261-262 

positioning relative to parent layout 168-169 

positioning views relative to other 170-171 

setting values in fragment 285 

text 

about 45-46 
attributes of 49 
referencing 59-60 

using gravity attribute in view 181,184 
using layout_gravity attribute 183-184 
using margins to add distance between 172 
ViewGroup as type of 203-204 
void return type, for buttons 58 

w 

watchMileage() method 589, 593 

Web View class 666 

Welcome Screen (Android Studio) 6, 8 


What’s My Purpose 
activity file code exercise 21-22 
layout file code exercise 19-20 
widget app 671 
Workout app 
about 273-274 
activity vs. fragment 282 
back stacks 299, 341 
creating project 274 
device layouts for 

determining which layout device is using 320 
different folder options 309 
layouts for phone 315-316, 319 
layouts for tablets 314 
phone vs. tablet 306-307 
putting screen-specific resources in folders 308 
running code 320-321 
fragment lifecycle 283-284 
fragments in 
about 274 

adding to project 276 
layout code 277-278,279 
passing workout id to 280 
linking fragments 295-305 
about 295 
code for 305 

interface for decoupling fragment 296-298 
replacing instances of WorkoutListFragment 
300-301 

rotating device 304 
updating Main Activity .j ava 302 
working with back button 299 
nested fragments 
about 325 

adding StopwatchFragment to WorkoutDetailFrag- 
ment 337-343 

attaching onClickListener to buttons 351 
code for 332-334, 352-354, 358-359 
creating 326 

error output for buttons in 345-346 
implementing onClickListener 349 
implementing StopwatchFragment onClick() method 
349-350 

needing nested transactions 341-342 
onClick attribute and 347-348 
rotating device containing 355-357 
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running 286-287 
StopwatchFragment in 
adding to WorkoutDetailFragment 337-343 
code for 332-333,352-354 
error output for buttons in 345-346 
layout for 335-336 
onClick attribute and 347-348 
onClick() method 349-350 
onCreateView() method 351 
workout class 275 
WorkoutDetailFragment 
about 274 

adding stopwatch fragment to 326 
adding StopwatchFragment to 337-343 
creating 276-281 
running 286-287 
setting views values 285 
WorkoutListFragment 
about 274 

adding to WorkoutListFragment 297 

code for 293 

creating 288-291 

replacing instances of 300-301 

running 294 

updating code 292 


WorkoutListListener 
creating interface called 296 
implementing interface 298 
wrap_content 
setting 166 
value 175,179 

X 

XML 

Android Studio creating 37 
source files in folder structure in Android Studio 
project 16 

Y 

Your Activity class 135 

Your Virtual Devices screen (Android Studio) 24 
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